有效管理任务在我们忙碌的生活中至关重要,而待办事项列表应用程序可以成为保持井井有条的绝佳工具。这篇博文将引导您完成使用 Django(一个强大且多功能的 Python Web 框架)开发待办事项列表应用程序的过程。该项目名为 django-todoList,旨在帮助用户无缝创建、管理和跟踪他们的日常任务。
已安装 Python(最好是 3.8 或更高版本)。
已安装 Django。如果没有,您可以使用以下命令安装它。
pip install django
首先,使用命令创建一个新的 Django 项目:
django-admin startproject mysite
导航到您的项目文件夹:
cd mysite
接下来,在项目中创建一个应用程序。我们将其称为 todoList:
python manage.py startapp todoList
在 Django 中,模型用于定义数据的结构。对于 GetDone 待办事项应用程序,我们需要一个模型来表示任务。
导航到 todoList/models.py 并定义任务模型:
from django.db import models from django.contrib.auth.models import User class Task(models.Model): title = models.CharField(max_length=200) description = models.TextField() complete = models.BooleanField(default=False) created = models.DateTimeField(auto_now_add=True) deadline = models.DateTimeField(null=True, blank=True) user = models.ForeignKey(User, on_delete=models.CASCADE) def __str__(self): return self.title
该模型包括标题、描述、截止日期和完成等字段,用于存储每个任务的详细信息。我们还通过用户外键将每个任务与用户关联。
模型准备就绪后,运行迁移以在数据库中为此模型创建表:
python manage.py makemigrations python manage.py migrate
我们需要表单来处理用户输入以创建和更新任务。在 todoList/forms.py 中,创建 TaskForm:
from django import forms from .models import Task class TaskForm(forms.ModelForm): class Meta: model = Task fields = ['title', 'description', 'deadline', 'complete'] widgets = { 'title': forms.TextInput(attrs={'placeholder': 'Enter task title'}), 'description': forms.Textarea(attrs={'placeholder': 'Enter task description', 'rows': 4}), 'deadline': forms.DateTimeInput(attrs={'type': 'datetime-local'}), 'complete': forms.CheckboxInput(), } def clean_title(self): title = self.cleaned_data.get('title') if not title: raise forms.ValidationError('Title is required') return title def clean_description(self): description = self.cleaned_data.get('description') if not description: raise forms.ValidationError('Description is required') return description def clean_deadline(self): deadline = self.cleaned_data.get('deadline') if not deadline: raise forms.ValidationError('Deadline is required') return deadline
TaskForm 使用 Django 的 ModelForm 为 Task 模型自动创建表单字段。
接下来,我们需要创建视图来处理用户请求,例如创建任务、更新任务和列出任务。
在todoList/views.py中,定义视图:
from django.shortcuts import render, redirect from django.views.generic import ListView, CreateView, UpdateView, DeleteView from django.contrib.auth.views import LoginView from django.contrib.auth.mixins import LoginRequiredMixin from django.contrib.auth.forms import UserCreationForm from django.urls import reverse_lazy from .models import Task from .forms import TaskForm from django.contrib import messages from django.utils import timezone # Task List View class TodoListView(LoginRequiredMixin, ListView): model = Task context_object_name = 'tasks' template_name = 'task_list.html' def get_context_data(self, **kwargs): context = super().get_context_data(**kwargs) user_tasks = Task.objects.filter(user=self.request.user) context['tasks'] = Task.objects.filter(user=self.request.user) context['incomplete_tasks_count'] = user_tasks.filter(complete=False).count() # Count incomplete tasks context['now'] = timezone.now() return context # Task Create View class TaskCreate(LoginRequiredMixin, CreateView): model = Task form_class = TaskForm template_name = 'todoList/task_create.html' success_url = reverse_lazy('todoList') def form_valid(self, form): form.instance.user = self.request.user messages.success(self.request, 'Task created successfully!') return super(TaskCreate, self).form_valid(form) # Task Update View class TaskUpdate(LoginRequiredMixin, UpdateView): model = Task form_class = TaskForm template_name = 'todoList/task_update.html' success_url = reverse_lazy('todoList') def form_valid(self, form): messages.success(self.request, 'Task updated successfully!') return super(TaskUpdate, self).form_valid(form) # Task Delete View class TaskDelete(LoginRequiredMixin, DeleteView): model = Task context_object_name = 'task' template_name = 'todoList/task_delete.html' success_url = reverse_lazy('todoList') def dispatch(self, request, *args, **kwargs): response = super().dispatch(request, *args, **kwargs) if response.status_code == 302: messages.success(self.request, 'Task deleted successfully!') return response # User Registration View class RegisterView(CreateView): form_class = UserCreationForm template_name = 'todoList/register.html' success_url = reverse_lazy('todoList') def form_valid(self, form): response = super().form_valid(form) # Log the user in after successful registration from django.contrib.auth import login login(self.request, self.object) messages.success(self.request, 'Registration successful! Welcome!') return response # Login View class CustomLoginView(LoginView): template_name = 'todoList/login.html' fields = '__all__' redirect_authenticated_user = True def get_success_url(self): messages.success(self.request, 'You have logged in successfully!') return reverse_lazy('todoList')
-TodoListView:列出登录用户的所有任务。
-TaskCreate:处理任务创建。
-TaskUpdate:允许用户更新任务。
-TaskDelete:提供删除任务的确认页面。
LoginRequiredMixin 确保只有登录的用户才能访问这些视图。
在 todoList/urls.py 中,将 URL 映射到各自的视图:
pip install django
这些 URL 模式会将每个视图映射到特定的 URL。例如,任务列表显示在应用的根URL处,用户可以通过访问特定URL来创建、编辑或删除任务。
创建以下 HTML 模板来渲染视图:
基本模板为所有页面提供一致的布局:
django-admin startproject mysite
在views.py中,你可以使用Django内置的用户认证视图来处理用户注册和登录。例如,您可以使用 UserCreationForm 来允许用户注册:
cd mysite
一切设置完毕后,您就可以运行服务器了:
python manage.py startapp todoList
访问 http://127.0.0.1:8000/todoList 查看您的待办事项列表应用程序的运行情况!
settings.py 文件是每个 Django 项目的重要组成部分。它包含项目的配置设置,例如数据库设置、安装的应用程序、中间件、静态文件配置等。该文件控制项目的行为并允许 Django 连接各个组件之间的点。
以下是 GetDone 待办事项列表应用的 settings.py 中关键设置的简要概述:
已安装的应用程序:在 INSTALLED_APPS 列表中,您注册项目中使用的所有应用程序。例如:
from django.db import models from django.contrib.auth.models import User class Task(models.Model): title = models.CharField(max_length=200) description = models.TextField() complete = models.BooleanField(default=False) created = models.DateTimeField(auto_now_add=True) deadline = models.DateTimeField(null=True, blank=True) user = models.ForeignKey(User, on_delete=models.CASCADE) def __str__(self): return self.title
在这里,我们添加了 todoList,它是管理任务的应用程序,以及 Django 提供的用于用户身份验证、管理面板和静态文件的默认应用程序。
在 Django 中,urls.py 文件处理 HTTP 请求到视图的路由。您可以在此处将 URL 模式(例如 /tasks/、/login/)映射到处理它们的相应视图。
在 mysite/urls.py 中,您通常包含整个项目的 URL,并将它们链接到应用程序级 urls.py 文件。
这是 urls.py 在 GetDone 应用程序中的样子:
项目级 urls.py (mysite/urls.py):mysite 文件夹中的 urls.py 文件是整个 Django 项目的主路由器。它包括管理面板、身份验证的 URL 以及指向应用程序特定 URL 的链接。这是一个例子:
pip install django
path('admin/', admin.site.urls):此行包含 Django 管理面板。
path('accounts/', include('django.contrib.auth.urls')): 这包括用于登录、注销和密码管理的内置身份验证 URL。
path('', include('todoList.urls')):这包括应用程序特定的 URL(在 todoList/urls.py 中定义),以便用户可以浏览任务和其他功能。
应用程序级 urls.py (todoList/urls.py):此文件将特定 URL 映射到 todoList 应用程序中的视图。它包含用于查看任务、创建任务和其他与任务相关的操作的路径。例如:
django-admin startproject mysite
TodoListView.as_view():此视图列出登录用户的所有任务。
TaskCreate.as_view():该视图处理任务创建表单。
TaskUpdate.as_view():该视图处理任务更新表单。
TaskDelete.as_view():该视图处理任务删除确认页面。
Django 的架构允许不同文件和组件之间顺利通信:
urls.py 将 URL 映射到视图,例如任务创建或列表查看。视图在views.py中定义。
视图与模型(在 models.py 中定义)交互以检索和操作数据(任务)。例如,在 TodoListView 中,视图使用 Task.objects.filter(user=self.request.user) 获取与登录用户关联的任务。
表单(如 forms.py 中的 TaskForm)处理用户输入并与模型交互以验证和保存数据。
模板以 HTML 形式呈现最终输出,显示从视图传递的数据并通过表单处理用户输入。
通过这些步骤,您已经使用 Django 构建了一个功能齐全的待办事项列表应用程序。您已经实现了用户身份验证、任务管理(创建、编辑、删除),并了解了 Django 的 MVC (MTV) 架构如何促进模型、视图、模板和 URL 之间的顺畅通信。本指南为将来构建更复杂的 Django 应用程序奠定了坚实的基础。
应用程序的完整代码可在
克隆
cd mysite
编码愉快! ?
以上是完成 ✅:构建 Django 待办事项列表的分步指南的详细内容。更多信息请关注PHP中文网其他相关文章!