Django基础之Form表单验证

Form表单验证

1.创建Form类（本质就是正则表达式的集合）

from django.forms import Form
from django.forms import fields
from django.forms import widgets
from Mybbs.models import *
import re

class UserForm(Form):
    username = fields.CharField(
        required=True,
        error_messages={'required':'用户名不能为空'},
        widget=widgets.TextInput(attrs={'class':'form-control'})
    )

    password = fields.CharField(
        required=True,
        error_messages={'required': '密码不能为空','invalid':'密码格式错误'},
        widget = widgets.TextInput(attrs={'class': 'form-control'})
    )

    ut_id = fields.ChoiceField(
        choices=[],
        widget=widgets.Select(attrs={'class':'form-control'})
    )

    role_id = fields.MultipleChoiceField(
        choices=[],
        widget=widgets.SelectMultiple(attrs={'class':'form-control'})
    )

创建自定义类继承Form,类属性最好与数据库字段名称相同：

required：不能为空
error_messages：错误信息
widget：渲染方式

# 如果需要读库的内容，则应该放入 类初始化方法中，不然数据库有更新，却更新不到页面，
# 因为类属性 只有在第一次生成的时候执行，而 初始化方法 在每次类被调用的时候都执行，能拿到第一手资料
def __init__(self, *args, **kwargs):
    super(UserForm, self).__init__(*args, **kwargs)
    # self.fields已经有所有拷贝的字段
    self.fields['ut_id'].choices = models.UserType.objects.values_list('id', 'title')
    self.fields['role_id'].choices = models.Role.objects.values_list('id', 'caption')

2.前端生成HTML

<form method="POST" novalidate>
	{% csrf_token %}
	<!--{{ form.as_p }}  生成form中所有的html标签 -->
	<p>
		用户名: {{ form.username }} {{ form.errors.username.0 }}
	</p>
	<p>
		密码: {{ form.password }}  {{ form.errors.password.0 }}
	</p>
	<p>
		用户类型: {{ form.ut_id }}  {{ form.errors.ut_id.0 }}
	</p>
	<p>
		角色: {{ form.role_id }}  {{ form.errors.role_id.0 }}
	</p>

	<input type="submit" value="提交" />
</form>

novalidate：禁止浏览器弹出的错误

3.带默认值的好HTML标签：编辑界面

class EditUserView(AuthView,View):

    def get(self, request, pk):
        obj = models.UserInfo.objects.filter(id=pk).first()
        role_id_list = obj.rl.values_list('id')
        v = list(zip(*role_id_list))[0] if role_id_list else []
        form = UserForm(initial={'username': obj.username, 'password': obj.password, 'ut_id': obj.ut_id,'role_id':v})
        return render(request,'edit_user.html',{'form':form})

    def post(self,request,pk):
        form = UserForm(data=request.POST)
        if form.is_valid():
            # # {'username': 'xxxxx', 'password': 'xxxxx', 'ut_id': '1',role_id:}
            role_id = form.cleaned_data.pop('role_id')
            # 用户表更新
            query = models.UserInfo.objects.filter(id=pk)
            query.update(**form.cleaned_data)
            obj = query.first()
            obj.rl.set(role_id)

            return redirect('/users.html')
        else:
            print(form.errors)
            return render(request, 'edit_user.html', {'form': form})

Form类

创建Form类时，主要涉及到 【字段】 和 【插件】，字段用于对用户请求数据的验证，插件用于自动生成HTML;

1.Django内置字段如下：

Field
    required=True,               是否允许为空
    widget=None,                 HTML插件
    label=None,                  用于生成Label标签或显示内容
    initial=None,                初始值
    help_text='',                帮助信息(在标签旁边显示)
    error_messages=None,         错误信息 {'required': '不能为空', 'invalid': '格式错误'}
    show_hidden_initial=False,   是否在当前插件后面再加一个隐藏的且具有默认值的插件（可用于检验两次输入是否一直）
    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类型
    ...

2.Django内置插件

TextInput(Input)
NumberInput(TextInput)
EmailInput(TextInput)
URLInput(TextInput)
PasswordInput(TextInput)
HiddenInput(TextInput)
Textarea(Widget)
DateInput(DateTimeBaseInput)
DateTimeInput(DateTimeBaseInput)
TimeInput(DateTimeBaseInput)
CheckboxInput
Select
NullBooleanSelect
SelectMultiple
RadioSelect
CheckboxSelectMultiple
FileInput
ClearableFileInput
MultipleHiddenInput
SplitDateTimeWidget
SplitHiddenDateTimeWidget
SelectDateWidget

实例：

 - 常用插件

             class RegisterForm(Form):
                 name = fields.CharField(
                     widget=widgets.TextInput(attrs={'class': 'c1'})
                 )
                 email = fields.EmailField(
                     widget=widgets.EmailInput(attrs={'class':'c1'})
                 )
                 phone = fields.CharField(
                     widget=widgets.Textarea(attrs={'class':'c1'})
                 )
                 pwd = fields.CharField(
                     widget=widgets.PasswordInput(attrs={'class':'c1'})
                 )
                 pwd_confirm = fields.CharField(
                     widget=widgets.PasswordInput(attrs={'class': 'c1'})
                 )
                 # 单选：select
                 # city = fields.ChoiceField(
                 #     choices=[(0,"上海"),(1,'北京')],
                 #     widget=widgets.Select(attrs={'class': 'c1'})
                 # )
                 # 多选：select
                 # city = fields.MultipleChoiceField(
                 #     choices=[(1,"上海"),(2,'北京')],
                 #     widget=widgets.SelectMultiple(attrs={'class': 'c1'})
                 # )

                 # 单选：checkbox
                 # city = fields.CharField(
                 #     widget=widgets.CheckboxInput()
                 # )

                 # 多选：checkbox
                 # city = fields.MultipleChoiceField(
                 #     choices=((1, '上海'), (2, '北京'),),
                 #     widget=widgets.CheckboxSelectMultiple
                 # )

                 # 单选：radio
                 # city = fields.CharField(
                 #     initial=2,
                 #     widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),))
                 # )

             注意：写默认值时，多选值对应列表

             # form = RegisterForm(initial={'city':[1,2],'name':'alex'})
             form = RegisterForm()

 实例