DjangoGirls教程：深入理解Django表单系统-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00361/article/details/148990521

DjangoGirls教程：深入理解Django表单系统

前言

在Web开发中，表单是与用户交互的重要组件。Django提供了强大而灵活的表单系统，让开发者能够轻松处理用户输入和数据验证。本文将详细介绍如何在Django项目中创建和使用表单，特别是ModelForm的使用方法。

Django表单基础

Django表单系统主要分为两种类型：

普通表单(Form)：用于处理与模型无关的数据
模型表单(ModelForm)：直接与模型关联，简化了模型数据的创建和更新

在博客应用中，我们将使用ModelForm来创建和编辑博客文章。

创建PostForm

首先需要在blog应用下创建forms.py文件：

from django import forms
from .models import Post

class PostForm(forms.ModelForm):
    class Meta:
        model = Post
        fields = ('title', 'text')

这段代码定义了一个与Post模型关联的表单类，其中：

model = Post 指定了表单关联的模型
fields = ('title', 'text') 定义了表单中需要显示的字段

表单视图实现

表单的处理通常需要视图函数支持GET和POST两种请求方法：

from django.shortcuts import render, redirect, get_object_or_404
from django.utils import timezone
from .forms import PostForm
from .models import Post

def post_new(request):
    if request.method == "POST":
        form = PostForm(request.POST)
        if form.is_valid():
            post = form.save(commit=False)
            post.author = request.user
            post.published_date = timezone.now()
            post.save()
            return redirect('post_detail', pk=post.pk)
    else:
        form = PostForm()
    return render(request, 'blog/post_edit.html', {'form': form})

视图函数的工作流程：

如果是POST请求：
- 使用提交的数据初始化表单
- 验证表单数据
- 如果有效，保存数据并重定向到详情页
如果是GET请求：
- 显示空表单

表单模板设计

创建post_edit.html模板文件：

{% extends 'blog/base.html' %}

{% block content %}
    <h2>{% if form.instance.pk %}Edit{% else %}New{% endif %} post</h2>
    <form method="POST" class="post-form">
        {% csrf_token %}
        {{ form.as_p }}
        <button type="submit" class="save btn btn-secondary">Save</button>
    </form>
{% endblock %}

模板中几个关键点：

{% csrf_token %}：防止跨站请求伪造的安全令牌
{{ form.as_p }}：将表单字段渲染为段落形式
根据是否编辑现有文章动态显示标题

编辑现有文章

编辑功能与创建类似，但需要传入现有文章实例：

def post_edit(request, pk):
    post = get_object_or_404(Post, pk=pk)
    if request.method == "POST":
        form = PostForm(request.POST, instance=post)
        if form.is_valid():
            post = form.save(commit=False)
            post.author = request.user
            post.save()
            return redirect('post_detail', pk=post.pk)
    else:
        form = PostForm(instance=post)
    return render(request, 'blog/post_edit.html', {'form': form})

表单验证

Django自动为模型字段添加验证逻辑。例如：

必填字段验证
字段类型验证
最大长度验证等

当表单验证失败时，Django会自动在页面上显示错误信息。

安全考虑

CSRF保护：必须包含{% csrf_token %}
权限控制：限制表单访问权限

{% if user.is_authenticated %}
    <a href="{% url 'post_new' %}" class="top-menu">
        {% include './icons/file-earmark-plus.svg' %}
    </a>
{% endif %}