python之路（20）django之Form组件

前言

　　Form组件的几大作用

• 生成HTML标签
• 验证用户数据（显示错误信息）
• HTML Form提交保留上次提交数据
• 初始化页面显示内容

目录

• Form组件的创建
• Form组件的内置字段
• Form组件的验证扩展

---

 Form组件的创建

views

from django.shortcuts import render,HttpResponse,redirect
from django import forms
from django.forms import fields


class F1Form(forms.Form):
    # 不能为空，长度6-18
    user = fields.CharField(
        max_length=18,
        min_length=6,
        required=True,
        #自定义错误的提示
        error_messages={'required': '用户名不能为空','max_length': '太长了','min_length': '太短了','invalid':'..'}
    )
    # 不能为空，长度32
    pwd = fields.CharField(required=True,min_length=32)
    # 不能为空，邮箱格式
    age = fields.IntegerField(
        required=True,
        error_messages={'required':'年龄不能为空', 'invalid':'必须为数字'}
    )
    # 不能为空，数字格式
    email = fields.EmailField(
        required=True,
        min_length=8,
        error_messages={'required':'邮箱不能为空', 'invalid':'邮箱格式错误'}
    )




def f1(request):
    if request.method == "GET":
        obj = F1Form()
        return  render(request,'f1.html',{'obj':obj})
    else:
        # u = request.POST.get('user') #不能为空，长度6-18
        # p = request.POST.get('pwd') #不能为空，长度32
        # e = request.POST.get('email') #不能为空，邮箱格式
        # a = request.POST.get('age') #不能为空，数字格式
        # print(u,p,e,a)

        # 检查是否为空
        # 检查格式是否正确
        obj = F1Form(request.POST)
        # 用户是否验证成功
        if obj.is_valid():
            #用户提交的数据
            print('验证成功',obj.cleaned_data)
            #验证失败返回<ul class="errorlist"><li>user<ul class="errorlist">
            # <li>Ensure this value has at least 6 characters (it has 4).</li></ul></li></ul>
            return redirect('http://www.baidu.com')
        else:
            #显示错误信息
            print('验证失败',obj.errors)
            #验证成功返回字典 {'user': '121212', 'pwd': '11111111111111111111111111111111', 'age': 12, 'email': '11111111@qq.com'}
            return  render(request,'f1.html',{'obj':obj})

        return  HttpResponse('OK')

html

    <form id="fm" action="/f1.html" method="POST" novalidate>
        <!--
        <P><input type="text" name="user"/>{{ obj.errors.user.0 }}</P>
        <P><input type="text" name="pwd"/>{{ obj.errors.pwd.0 }}</P>
        <P><input type="text" name="age"/>{{ obj.errors.age.0 }}</P>
        <P><input type="text" name="email"/>{{ obj.errors.email.0}}</P>
        -->
        <!--
         <p>{{ obj.as_p }}</p> 
        -->
        <p>{{ obj.as_p }}</p>
        <P>{{ obj.user }}{{ obj.errors.user.0 }}</P>
        <P>{{ obj.pwd }}{{ obj.errors.pwd.0 }}</P>
        <P>{{ obj.age }}{{ obj.errors.age.0 }}</P>
        <P>{{ obj.email }}{{ obj.errors.email.0}}</P>
        <input type="submit" value="提交"/>
    </form>

---

 Form类的内置字段

Fields
        required = True,            #是否必填
        error_messages = {}          #自定义错误提示
        widget = widgets.Select(),   #定制HTML插件
        label = '用户名',            #{{obj.user.label}}
        initial = '请输入默认值',    #添加默认值
        help_text = '帮助文档',
        show_hidden_initial = True,  #是否在当前插件后面在加一个隐藏且具有默认值的插件(可用于检验两次输入是否一致)
        validators = [],             #自定制验证规则
        localize = False,            #是否支持本地化
        disabled = False,            #是否可编辑
        label_suffix = ':',          #后缀


CharField(Fields)
        max_length = None,        #最大长度
        min_length = None,        #最小长度
        strip = True,             #是否移除空白
        error_messages = {'max_length': '太长了', 'min_length': '太短了'},   #自定义错误提示


RegexField(CharField)
        regex,                  #自定制正则表达式
        error_messages=None，   #error_messages={'invalid':'格式错误的字段都是invalid'}


URLField(CharField)
        ...


EmailField(CharField)
        ...
    

SlugField(CharField)      #数字，字母，下划线，减号（连字符）
        ...


UUIDField(CharField)      #uuid类型
        ...


FileField(Field)
        max_length = None,            #设置最大长度
        allow_empty_file = False，    #是否允许为空


ImageField(FileField)
        ...
        注：需要PIL模块，pip3 install Pillow
        以上两个字典使用时，需要注意两点：
            - form表单中 enctype="multipart/form-data"
            - view函数中 obj = MyForm(request.POST, request.FILES)


ChoiceField(Field)
        choices=(),             #选项，如：choices = ((0,'上海'),(1,'北京'),)


ModelChoiceField(ChoiceField)
        ...                        django.forms.models.ModelChoiceField
        queryset,                  # 查询数据库中的数据
        empty_label="---------",  # 默认空显示内容
        to_field_name=None,        # HTML中value的值对应的字段
        limit_choices_to=None      # ModelForm中对queryset二次筛选


FilePathField(ChoiceField)     #文件选项，目录下文件显示在页面中
        path,                      #文件夹路径
        match=None,                #正则匹配
        recursive=False,           #递归下面的文件夹
        allow_files=True,          #允许文件
        allow_folders=False,       #允许文件夹
        required=True,
        widget=None,
        label=None,
        initial=None,
        help_text=''


IntegerField(Fields)
        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 - 0111: 12

DurationField(Field)  #时间间隔： % d % H: % M: % S. % f
        ...

GenericIPAddressField
        protocol = 'both',      #both, ipv4, ipv6支持的IP格式
        unpack_ipv4 = False     #解析ipv4地址，如果是::ffff: 192.0.2.1时候，可解析为192.0.2.1， PS：protocol必须为both才能启用

注：在使用选择标签时，需要注意choices的选项可以从数据库中获取，但是由于是静态字段 ***获取的值无法实时更新***，那么需要自定义构造方法从而达到此目的。

方式一：

from django.forms import Form
from django.forms import widgets
from django.forms import fields


class MyForm(Form):
    user = fields.ChoiceField(
        # choices=((1, '上海'), (2, '北京'),),
        initial=2,
        widget=widgets.Select
    )

    def __init__(self, *args, **kwargs):
        super(MyForm, self).__init__(*args, **kwargs)
        # self.fields['user'].widget.choices = ((1, '上海'), (2, '北京'),)
        # 或
        self.fields['user'].widget.choices = models.Classes.objects.all().value_list('id', 'caption')　　

方法二:

使用django提供的ModelChoiceField和ModelMultipleChoiceField字段来实现

from django import forms
from django.forms import fields
from django.forms import widgets
from django.forms import models as form_model


class FInfo(forms.Form):
    authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all())
    # authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all())

---

Form组件的验证扩展

 方法一:

使用RegexValidator模块

from django.forms import Form
from django.forms import fields
from django.core.validators import RegexValidator


class MyForm(Form):
    user = fields.CharField(
        error_messages={'invalid': '.....'},
        validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
    )

方法二:

使用 RegexField字段

from django.forms import Form
from django.forms import widgets
from django.forms import fields


class MyForm(Form):
    user = fields.RegexField(r'^[0-9]+$',error_messages={'invalid':'.....'})

方法三:

自定义方法，自定义方法 clean_字段名

from django.shortcuts import render
from django import forms
from django.forms import fields
from django.forms import widgets
from app03 import models
# Create your views here.

from django.core.exceptions import NON_FIELD_ERRORS, ValidationError


class MyForm(forms.Form):
    username = fields.CharField()
    user_id = fields.IntegerField(
        widget=widgets.Select(choices=[(0, 'chen'), (1, 'xiaoyi'), (2, 'liu'), ])
    )

    # 自定义方法 clean_字段名
    # 必须返回值self.cleaned_data['username']
    # 如果出错：raise ValidationError('用户名已存在')
    def clean_username(self):
        v = self.cleaned_data['username']
        if models.UserInfo.objects.filter(username=v).count():
            # 自己详细错误信息
            raise ValidationError('用户名已存在')
        return v

    def clean_user_id(self):
        return self.cleaned_data['user_id']

    #整体的错误信息返回
    def clean(self):
        value_dict = self.cleaned_data
        v1 = value_dict.get('username')
        v2 = value_dict.get('user_id')
        if v1 == 'root' and v2 == 1:
            raise ValidationError('整体错误信息')
        return self.cleaned_data　

在源码中会会通过反射去执行clean_"字段名"的方法，再将值赋值给self.cleaned_data[name]

    def _clean_fields(self):
        for name, field in self.fields.items():
            # value_from_datadict() gets the data from the data dictionaries.
            # Each widget type knows how to retrieve its own data, because some
            # widgets split data over several HTML fields.
            if field.disabled:
                value = self.get_initial_for_field(field, name)
            else:
                value = field.widget.value_from_datadict(self.data, self.files, self.add_prefix(name))
            try:
                if isinstance(field, FileField):
                    initial = self.get_initial_for_field(field, name)
                    value = field.clean(value, initial)
                else:
                    value = field.clean(value)
                self.cleaned_data[name] = value
                if hasattr(self, 'clean_%s' % name):
                    value = getattr(self, 'clean_%s' % name)()
                    self.cleaned_data[name] = value
            except ValidationError as e:
                self.add_error(name, e)