当前位置：首页 > article >正文

Django ModelForm使用（初学）

article 2025/2/24 8:30:51

1.目的是根据员工表字段，实现一个新增员工的数据填写页面

2.在views.py文件中按下面的格式写

定义 ModelForm 类：UserModelForm （自己命名的类名）使用时需要导入包

定义视图函数：user_model_form_add（在函数中使用form = UserModelForm()）

定义了一个 Django ModelForm 类 UserModelForm，用于创建或编辑 UserInfo 模型的实例，表单包含 name、password、age、account、create_time、gender 和 depart 字段。在 __init__ 方法中，为每个字段的 HTML 输入元素动态添加了 class="form-control" 和 placeholder 属性，以便使用 Bootstrap 样式并显示字段标签作为占位符。user_model_form_add 视图函数处理 GET 和 POST 请求：当用户访问页面时（GET 请求），渲染一个空表单；当用户提交表单时（POST 请求），验证表单数据，如果数据有效则保存到数据库并重定向到 /user/list 页面，如果数据无效则打印错误信息（用于调试）。

表单定义：通过 ModelForm 快速生成与模型关联的表单，并自定义字段的 HTML 属性。
视图处理：处理用户请求，显示空表单或验证并保存提交的数据，最后重定向或返回错误信息。

注意：form.save() 会将数据保存到数据库中，这个数据库就是我们在UserModelForm中定义的model = models.UserInfo，即UserInfo表

from django.shortcuts import render,redirect
from employees import models
from django import forms

class UserModelForm(forms.ModelForm):
    class Meta:
        model = models.UserInfo
        fields = ["name","password","age", "account", "create_time", "gender", "depart"]
        
    def __init__(self, *args, **kwargs):
        # 调用父类的初始化方法
        super().__init__(*args, **kwargs)
        # 遍历表单中的所有字段
        for name, field in self.fields.items():
            # 为每个字段的 widget 添加 HTML 属性
            field.widget.attrs = {
                "class": "form-control",  # 添加 Bootstrap 样式
                "placeholder": field.label  # 设置占位符为字段的标签
            }
            
def user_model_form_add(request):
    # 处理 GET 请求：显示空表单
    if request.method == 'GET':
        form = UserModelForm()  # 创建一个空的 UserModelForm 实例
        # 渲染模板，并将表单对象传递给模板
        return render(request, 'user_model_form_add.html', {"form": form})
    
    # 处理 POST 请求：提交表单数据
    form = UserModelForm(data=request.POST)
    
    # 验证表单数据是否有效
    if form.is_valid():
        # 如果数据有效，保存表单数据到数据库
        form.save()
        return redirect("/user/list")  # 重定向到用户列表页面
    else:
        # 如果数据无效，打印错误信息（用于调试）
        print(form.errors)

user_model_form_add.html 使用传递过来的数据

完整代码

{% extends 'layout.html' %}

{% block content %}
<div class="container">
    <div class="c1">
        <a class="btn btn-success" href="/user/add">新建用户</a>
    </div>

    <div class="c1">
        <a class="btn btn-success" href="/user/model/form/add">新建用户ModelForm</a>
    </div>

    <div class="card c1">
        <div class="card-header">
            新建用户
        </div>
        <div class="card-body">
            <form method="post">
                {% csrf_token %}
                {% for field in form%}
                <div class="form-label">
                    <label>{{ field.label }}</label>
                    {{ field }}
                </div>
                {% endfor %}

                <button type="submit" class="btn btn-primary">提交</button>
            </form>

        </div>

    </div>

</div>
{% endblock %}

实现效果

输入数据，提交

添加成功

3.校验错误信息提示

上面编写的错误输出只是测试，我想直接在网页上显示错误提示，这样更直观，代码修改如下

def user_model_form_add(request):
    # 处理 GET 请求：显示空表单
    if request.method == 'GET':
        form = UserModelForm()  # 创建一个空的 UserModelForm 实例
        # 渲染模板，并将表单对象传递给模板
        return render(request, 'user_model_form_add.html', {"form": form})

    # 处理 POST 请求：提交表单数据
    form = UserModelForm(data=request.POST)

    # 验证表单数据是否有效
    if form.is_valid():
        # 如果数据有效，保存表单数据到数据库
        form.save()
        return redirect("/user/list")  # 重定向到用户列表页面
    else:
        # 校验失败，在页面上显示错误信息
        return render(request, 'user_model_form_add.html', {"form": form})

user_model_form_add.html增加这一行

<span style="color: red;">{{ field.errors.0 }}</span>

效果如下，出现提示

上面的是浏览器做的校验，我们想自己校验提示，增加一个：novalidate

效果如下

我想对都写字段增加限制，Django会自动检查，例如

重写name和password字段，设置最小长度和标签，如果用户输入的长度不足，Django 会自动显示错误提示。

效果

更复杂的写法

注意导入对应的库

from django.shortcuts import render,redirect
from employees import models
from django import forms
from django.core.validators import MinLengthValidator, RegexValidator

class UserModelForm(forms.ModelForm):
    name = forms.CharField(min_length=3,label="用户名")
    password = forms.CharField(
        label="密码",
        widget=forms.PasswordInput(),
        validators=[
            MinLengthValidator(6, message="密码长度不能少于 6 个字符。"),
            RegexValidator(
                regex=r'^(?=.*\d)(?=.*[a-zA-Z]).{6,20}$',
                message="密码必须包含字母和数字，且长度为 6-20 个字符。"
            )
        ]
    )

    class Meta:
        model = models.UserInfo
        fields = ["name","password","age", "account", "create_time", "gender", "depart"]

    def __init__(self, *args, **kwargs):
        # 调用父类的初始化方法
        super().__init__(*args, **kwargs)
        # 遍历表单中的所有字段
        for name, field in self.fields.items():
            # 为每个字段的 widget 添加 HTML 属性
            field.widget.attrs = {
                "class": "form-control",  # 添加 Bootstrap 样式
                "placeholder": field.label  # 设置占位符为字段的标签
            }

效果