Django高级-Form表单组件应用

于 2019-05-05 21:33:29 发布
阅读量349 收藏 1
点赞数
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/chengchuanji/article/details/89855811
本文深入探讨Django的Form组件，详细阐述其在创建注册页面、数据验证及错误信息显示中的作用。通过实例展示了如何在views.py、register.html和models.py中应用Form，列举了常用的字段类型如CharField、ChoiceField、MultipleChoiceField，并介绍了相关参数。同时，文章还讨论了模板文件中的两种操作方式来处理Form数据。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

form组件做的三件事

  1. 要有一个注册的页面，页面里面要有form表单 --> 生成HTML代码
  2. form表单要能提交数据到后端，后端要做有效性校验 --> 数据有效性校验
  3. 要把校验的提示信息展示在页面上 --> 校验信息返回并展示，保存原来填写的内容

form组件的应用

例子

from django.shortcuts import render, HttpResponse
from django import forms
from django.forms import widgets
from app01 import models
from django.core.validators import RegexValidator
from django.core.exceptions import ValidationError

# Create your views here.


# 定义一个form表单的类
class RegForm(forms.Form):
    name = forms.CharField(
        max_length=10,
        label="用户名",
        error_messages={"max_length": "用户名不能大于10位", "required": "该字段不能为空"},
        widget=widgets.TextInput(attrs={"class": "form-control"})
    )
    pwd = forms.CharField(
        max_length=16,
        min_length=6,
        label="密码",
        error_messages={"max_length": "密码不能大于16位", "min_length": "密码不能小于6位", "required": "该字段不能为空"},
        widget=widgets.PasswordInput(attrs={"class": "form-control"}, render_value=True)    # 校验后将密码留在原来的输入框
    )
    confirm_pwd = forms.CharField(
        max_length=16,
        min_length=6,
        label="确认密码",
        error_messages={"max_length": "密码不能大于16位", "min_length": "密码不能小于6位", "required": "该字段不能为空"},
        widget=widgets.PasswordInput(attrs={"class": "form-control"}, render_value=True)    # 校验后将密码留在原来的输入框
    )
    email = forms.EmailField(
        label="邮箱",
        error_messages={
            "required": "该字段不能为空",
        },
        widget=widgets.EmailInput(attrs={"class": "form-control"})
    )
    phone = forms.CharField(
        max_length=11,
        label="手机",
        validators=[
            RegexValidator(r‘^[0-9]+$‘, ‘手机号必须是数字‘),
            RegexValidator(r‘^1[3-9][0-9]{9}$‘, ‘手机格式有误‘)
        ],
        widget=widgets.TextInput(attrs={"class": "form-control"}),
        error_messages={"required": "该字段不能为空"}
    )
    city = forms.fields.ChoiceField(
        choices=models.City.objects.all().values_list(‘id‘, ‘name‘),
        label="爱好",
        initial=3,
        widget=forms.widgets.Select()
    )

    # 重写父类的init方法
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.fields["city"].widget.choices = models.City.objects.all().values_list(‘id‘, ‘name‘)

    # 重写父类的clean方法
    def clean(self):
        # 此时 通过检验的字段的数据都保存在 self.cleaned_data
        pwd = self.cleaned_data.get("pwd")
        confirm_pwd = self.cleaned_data.get("confirm_pwd")
        if pwd != confirm_pwd:
            self.add_error("confirm_pwd", ValidationError("两次密码不一致"))
            raise ValidationError("两次密码不一致")
        return self.cleaned_data

    # 增加一个clean_%方法
    def clean_name(self):
        value = self.cleaned_data.get("name")
        if "jinpingmei" in value:
            raise ValidationError("不符合社会主义核心价值观！")
        return value


def register(request):
    form_obj = RegForm()
    if request.method == ‘POST‘:
        # 实例化form对象的时候，把post提交过来的数据直接传进去
        form_obj = RegForm(request.POST)      # 重写form_obj
        # 调用form_obj校验数据的方法
        if form_obj.is_valid():
            del form_obj.cleaned_data[‘confirm_pwd‘]
            models.UserInfo.objects.create(**form_obj.cleaned_data)
            return HttpResponse("注册成功")
    return render(request, ‘register.html‘, {‘form_obj‘: form_obj})

views.py

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>注册页面</title>
    <link href="/static/bootstrap/css/bootstrap.min.css" rel="stylesheet">
</head>
<body>
<div class="container">
    <div class="low">
        <div class="col-md-6 col-md-offset-3">
            <h1>用户注册</h1>
            <form action="" method="post" novalidate>
                {% csrf_token %}

                <div class="form-group {% if form_obj.name.errors.0 %}
                    has-error
                {% endif %}">
                    {{ form_obj.name.label }}
                    {{ form_obj.name }}
                    <span class="help-block">{{ form_obj.name.errors.0 }}</span>
                </div>

                <div class="form-group {% if form_obj.pwd.errors.0 %}
                    has-error
                {% endif %}">
                    {{ form_obj.pwd.label }}
                    {{ form_obj.pwd }}
                    <span class="help-block">{{ form_obj.pwd.errors.0 }}</span>
                </div>

                <div class="form-group {% if form_obj.confirm_pwd.errors.0 %}
                    has-error
                {% endif %}">
                    {{ form_obj.confirm_pwd.label }}
                    {{ form_obj.confirm_pwd }}
                    <span class="help-block">{{ form_obj.confirm_pwd.errors.0 }}</span>
                </div>

                <div class="form-group {% if form_obj.email.errors.0 %}
                    has-error
                {% endif %}">
                    {{ form_obj.email.label }}
                    {{ form_obj.email }}
                    <span class="help-block">{{ form_obj.email.errors.0 }}</span>
                </div>

                <div class="form-group {% if form_obj.phone.errors.0 %}
                    has-error
                {% endif %}">
                    {{ form_obj.phone.label }}
                    {{ form_obj.phone }}
                    <span class="help-block">{{ form_obj.phone.errors.0 }}</span>
                </div>


                <div class="form-group {% if form_obj.city.errors.0 %}
                    has-error
                {% endif %}">
                    {{ form_obj.city.label }}
                    {{ form_obj.city }}
                    <span class="help-block">{{ form_obj.city.errors.0 }}</span>
                </div>

                <button type="submit" class="btn btn-default">注册</button>
                <hr>

            </form>
{#{{ form_obj.as_p }}#}

        </div>
    </div>

</div>

<hr>

{#{{ form_obj.as_p }}#}

<script src="/static/jquery-3.2.1.min.js"></script>
<script src="/static/bootstrap/js/bootstrap.min.js"></script>
</body>
</html>

register.html

from django.db import models

# Create your models here.


class UserInfo(models.Model):
    name = models.CharField(max_length=32, unique=True, null=False)
    pwd = models.CharField(max_length=32, null=False)
    email = models.EmailField(null=True)
    phone = models.CharField(max_length=11, null=True)
    city = models.CharField(max_length=32, null=True)


class City(models.Model):
    name = models.CharField(max_length=32)

models.py
常用字段
CharField

widget=forms.widgets.TextInput()            # type=text
widget=forms.widgets.PasswordInput()        # type=password

ChoiceField

widget=forms.widgets.RadioSelect()            # type=radio
widget=forms.widgets.CheckboxInput()          # type=checkbox
widget=forms.widgets.Select()                 # type=select

MultipleChoiceField

widget=forms.widgets.CheckboxSelectMultiple()    # type=checkbox        并且 multiple
widget=forms.widgets.SelectMultiple()            # type=select          并且 multiple

常用参数

abel              # 标题
initial            # 初始值
error_messages     # 错误信息
choices            # 选择框内容
max_length         # 最大长度
min_length         # 最小长度
validators         # 正则校验相关

widget             # 插件
    attrs            设置属性
    render_value    把密码还留在原来的地方

Field
    required=True,               是否允许为空
    widget=None,                 HTML插件
    label=None,                  用于生成Label标签或显示内容
    initial=None,                初始值
    help_text=‘‘,                帮助信息(在标签旁边显示)
    error_messages=None,         错误信息 {‘required‘: ‘不能为空‘, ‘invalid‘: ‘格式错误‘}
    validators=[],               自定义验证规则
    localize=False,              是否支持本地化
    disabled=False,              是否可以编辑
    label_suffix=None            Label内容后缀
 
 
CharField(Field)
    max_length=None,             最大长度
    min_length=None,             最小长度
    strip=True                   是否移除用户输入空白
 
IntegerField(Field)
    max_value=None,              最大值
    min_value=None,              最小值
 
FloatField(IntegerField)
    ...
 
DecimalField(IntegerField)
    max_value=None,              最大值
    min_value=None,              最小值
    max_digits=None,             总长度
    decimal_places=None,         小数位长度
 
BaseTemporalField(Field)
    input_formats=None          时间格式化   
 
DateField(BaseTemporalField)    格式：2015-09-01
TimeField(BaseTemporalField)    格式：11:12
DateTimeField(BaseTemporalField)格式：2015-09-01 11:12
 
DurationField(Field)            时间间隔：%d %H:%M:%S.%f
    ...
 
RegexField(CharField)
    regex,                      自定制正则表达式
    max_length=None,            最大长度
    min_length=None,            最小长度
    error_message=None,         忽略，错误信息使用 error_messages={‘invalid‘: ‘...‘}
 
EmailField(CharField)      
    ...
 
FileField(Field)
    allow_empty_file=False     是否允许空文件
 
ImageField(FileField)      
    ...
    注：需要PIL模块，pip3 install Pillow
    以上两个字典使用时，需要注意两点：
        - form表单中 enctype="multipart/form-data"
        - view函数中 obj = MyForm(request.POST, request.FILES)
 
URLField(Field)
    ...
 
 
BooleanField(Field)  
    ...
 
NullBooleanField(BooleanField)
    ...
 
ChoiceField(Field)
    ...
    choices=(),                选项，如：choices = ((0,‘上海‘),(1,‘北京‘),)
    required=True,             是否必填
    widget=None,               插件，默认select插件
    label=None,                Label内容
    initial=None,              初始值
    help_text=‘‘,              帮助提示
 
 
ModelChoiceField(ChoiceField)
    ...                        django.forms.models.ModelChoiceField
    queryset,                  # 查询数据库中的数据
    empty_label="---------",   # 默认空显示内容
    to_field_name=None,        # HTML中value的值对应的字段
    limit_choices_to=None      # ModelForm中对queryset二次筛选
     
ModelMultipleChoiceField(ModelChoiceField)
    ...                        django.forms.models.ModelMultipleChoiceField
 
 
     
TypedChoiceField(ChoiceField)
    coerce = lambda val: val   对选中的值进行一次转换
    empty_value= ‘‘            空值的默认值
 
MultipleChoiceField(ChoiceField)
    ...
 
TypedMultipleChoiceField(MultipleChoiceField)
    coerce = lambda val: val   对选中的每一个值进行一次转换
    empty_value= ‘‘            空值的默认值
 
ComboField(Field)
    fields=()                  使用多个验证，如下：即验证最大长度20，又验证邮箱格式
                               fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),])
 
MultiValueField(Field)
    PS: 抽象类，子类中可以实现聚合多个字典去匹配一个值，要配合MultiWidget使用
 
SplitDateTimeField(MultiValueField)
    input_date_formats=None,   格式列表：[‘%Y--%m--%d‘, ‘%m%d/%Y‘, ‘%m/%d/%y‘]
    input_time_formats=None    格式列表：[‘%H:%M:%S‘, ‘%H:%M:%S.%f‘, ‘%H:%M‘]
 
FilePathField(ChoiceField)     文件选项，目录下文件显示在页面中
    path,                      文件夹路径
    match=None,                正则匹配
    recursive=False,           递归下面的文件夹
    allow_files=True,          允许文件
    allow_folders=False,       允许文件夹
    required=True,
    widget=None,
    label=None,
    initial=None,
    help_text=‘‘
 
GenericIPAddressField
    protocol=‘both‘,           both,ipv4,ipv6支持的IP格式
    unpack_ipv4=False          解析ipv4地址，如果是::ffff:192.0.2.1时候，可解析为192.0.2.1， PS：protocol必须为both才能启用
 
SlugField(CharField)           数字，字母，下划线，减号（连字符）
    ...
 
UUIDField(CharField)           uuid类型

Django-Form所有内置字段
常用字段示例
text

class LoginForm(forms.Form):
    ...
    name = forms.CharField(
        max_length=10,
        label="用户名",
        error_messages={"max_length": "用户名不能大于10位", "required": "该字段不能为空"},
        widget=widgets.TextInput()
    )

password

class LoginForm(forms.Form):
    ...
    pwd = forms.CharField(
        min_length=6,
        label="密码",
        widget=forms.widgets.PasswordInput(attrs={‘class‘: ‘c1‘}, render_value=True)
    )

radio

class LoginForm(forms.Form):
    ...
    gender = forms.fields.ChoiceField(
        choices=((1, "男"), (2, "女"), (3, "保密")),
        label="性别",
        initial=3,
        widget=forms.widgets.RadioSelect()
    )

checkbox
单选

class LoginForm(forms.Form):
    ...
    keep = forms.fields.ChoiceField(
        label="是否记住密码",
        initial="checked",
        widget=forms.widgets.CheckboxInput()
    )

多选

class LoginForm(forms.Form):
    ...
    hobby = forms.fields.MultipleChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
        label="爱好",
        initial=[1, 3],
        widget=forms.widgets.CheckboxSelectMultiple()
    )

select
单选

class LoginForm(forms.Form):
    ...
    hobby = forms.fields.ChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
        label="爱好",
        initial=3,
        widget=forms.widgets.Select()
    )

多选

class LoginForm(forms.Form):
    ...
    hobby = forms.fields.MultipleChoiceField(
        choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
        label="爱好",
        initial=[1, 3],
        widget=forms.widgets.SelectMultiple()
    )

校验

form_obj = RegForm(request.POST)        # 先重写
form_obj.is_valid()                     # 做校验

所有经过校验的数据都保存在

from django.core.validators import RegexValidator
# 写在要校验的字段的参数里
validators=[
    RegexValidator(r‘^[0-9]+$‘, ‘手机号必须是数字‘),
    RegexValidator(r‘^1[3-9][0-9]{9}$‘, ‘手机格式有误‘)
],

在模板文件里的操作

方式一

{{ form_obj.as_p }}

方式二
单独一个一个字段的写

{{ form_obj.name.label }}
{{ form_obj.name }}
{{ form_obj.pwd.label }}
{{ form_obj.pwd }}
乎乎你
关注
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值