Django框架基础之Form组件

服务端假设所有用户提交的数据都是不可信任的，所以Django框架内置了form组件来验证用户提交的信息

form组件的2大功能：
       1 验证（显示错误信息）
       2 保留用户上次输入的信息
                  -- 可以生成html标签
应用：

class A_Form(Form):
               字段=fields.字段类型（默认参数：
                     required=True,
                      widget=widgets.插件(attrs={})）

           常用字段:Charfield,RegexField,IntegerField,EmailField
           常用参数：max_length，min_length，
                     widget=widgets.Select(choices=models.Classes.objects.values_list('id','title'))
                     error_messages={
                         'required':'用户名不能为空',
                         'max_length':'太长了',
                         'min_length':'太短了',
                               }
                     label='用户名',  # obj.t1.label
             disabled=False,              # 是否可以编辑
             label_suffix='--->',            # Label内容后缀
                 help_text='。。。。。。',  # 提供帮助信息

      obj=A_Form(initial='')#生成空的html标签，含有默认值

      obj=A-Form(request.POST)#拿到浏览器请求，传入form做验证
      obj.is_valid()#判断验证是否通过
      obj.cleaned_data()#验证通过后的值  字典形式
      obj.errors   #form 返回的错误信息  是个对象   'obj.errors.字典.0 ' 获取第一个错误信息

原理：

LoginForm实例化时：self.fields={
                       'username':正则表达式
                       'password':正则表达式}
循环self.fields
        flag=True
        errors
        cleaned_data
        for k,v in self.fields.items():
              username ,正则
              input_value=request.POST.get(k)
              input_value,正则
              flag=false /true
        return flag

ModelForm
    a.  class Meta:
            model,                           # 对应Model的
            fields=None,                     # 字段
            exclude=None,                    # 排除字段
            labels=None,                     # 提示信息
            help_texts=None,                 # 帮助提示信息
            widgets=None,                    # 自定义插件
            error_messages=None,             # 自定义错误信息（整体错误信息from django.core.exceptions import NON_FIELD_ERRORS）
            field_classes=None               # 自定义字段类 （也可以自定义字段）
            localized_fields=('birth_date',) # 本地化，如：根据不同时区显示数据
            如：
                数据库中
                    2016-12-27 04:10:57
                setting中的配置
                    TIME_ZONE = 'Asia/Shanghai'
                    USE_TZ = True
                则显示：
                    2016-12-27 12:10:57
    b. 验证执行过程
        is_valid -> full_clean -> 钩子 -> 整体错误

    c. 字典字段验证
        def clean_字段名(self):
            # 可以抛出异常
            # from django.core.exceptions import ValidationError
            return "新值"
    d. 用于验证
        model_form_obj = XXOOModelForm()
        model_form_obj.is_valid()
        model_form_obj.errors.as_json()
        model_form_obj.clean()
        model_form_obj.cleaned_data
    e. 用于创建
        model_form_obj = XXOOModelForm(request.POST)
        #### 页面显示，并提交 #####
        # 默认保存多对多
            obj = form.save(commit=True)
        # 不做任何操作，内部定义 save_m2m（用于保存多对多）
            obj = form.save(commit=False)
            obj.save()      # 保存单表信息
            obj.save_m2m()  # 保存关联多对多信息

    f. 用于更新和初始化
        obj = model.tb.objects.get(id=1)
        model_form_obj = XXOOModelForm(request.POST,instance=obj)
        ...

        PS: 单纯初始化
            model_form_obj = XXOOModelForm(initial={...})

扩展：

1.由于form组件中每个字段都是类的数据属性（全局变量），在类每次实例化之后，数据属性不会发生改变，会保留上次的更新结果
           导致无法动态显示数据库的内容

解决方法一：每次实例化之前，更新xx字段的值
     xx=fields.MultipleChoiceField(
        # choices=models.Classes.objects.values_list('id','title'),
        widget=widgets.SelectMultiple
      )

    def __init__(self,*args,**kwargs):
        super(TeacherForm,self).__init__(*args,**kwargs)
        self.fields['xx'].choices=models.Classes.objects.values_list('id','title')

    解决方法二：不推荐
     from django.forms import models as form_model
     xx=form_model.ModelMultipleChoiceField(queryset=models.Classes.objects.all())

      models中：
       def __str__(self):
           return self.title

2. 扩展字段

单选：ChoiceField
          多选：MultipleChoiceField
                    Select框：
            单选
                            cls_id = fields.IntegerField(
                        # widget=widgets.Select(choices=[(1,'上海'),(2,'北京')])
                        widget=widgets.Select(choices=models.Classes.objects.values_list('id','title'))
                    )

                    cls_id = fields.ChoiceField(
                        choices=models.Classes.objects.values_list('id','title'),
                        widget=widgets.Select(attrs={'class': 'form-control'})
                    )

                    obj = FooForm({'cls_id':1})
            多选
                    xx = fields.MultipleChoiceField(
                        choices=models.Classes.objects.values_list('id','title'),
                        widget=widgets.SelectMultiple
                    )

                    obj = FooForm({'cls_id':[1,2,3]})
          文件：FileField

常用选择插件

 # 单radio，值为字符串
 # user = fields.CharField(
 #     initial=2,
 #     widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),))
 # )

 # 单radio，值为字符串
 # user = fields.ChoiceField(
 #     choices=((1, '上海'), (2, '北京'),),
 #     initial=2,
 #     widget=widgets.RadioSelect
 # )

 # 单select，值为字符串
 # user = fields.CharField(
 #     initial=2,
 #     widget=widgets.Select(choices=((1,'上海'),(2,'北京'),))
 # )

 # 单select，值为字符串
 # user = fields.ChoiceField(
 #     choices=((1, '上海'), (2, '北京'),),
 #     initial=2,
 #     widget=widgets.Select
 # )

 # 多选select，值为列表
 # user = fields.MultipleChoiceField(
 #     choices=((1,'上海'),(2,'北京'),),
 #     initial=[1,],
 #     widget=widgets.SelectMultiple
 # )

 # 单checkbox
 # user = fields.CharField(
 #     widget=widgets.CheckboxInput()
 # )

 # 多选checkbox,值为列表
 # user = fields.MultipleChoiceField(
 #     initial=[2, ],
 #     choices=((1, '上海'), (2, '北京'),),
 #     widget=widgets.CheckboxSelectMultiple
 # )

扩展插件

 扩展插件：
            Textarea
            CheckboxInput
            CheckboxSelectMultiple
            RadioSelect
            FileInput

     t1=fields.CharField(
         widget=widgets.Textarea(attrs={})
     )
     t2=fields.CharField(
         widget=widgets.CheckboxInput
     )
     t3=fields.MultipleChoiceField(
         choices=[(1,'篮球'),(2,'足球')],
         widget=widgets.CheckboxSelectMultiple
     )
     t4=fields.ChoiceField(
         choices=[(1,'篮球'),(2,'足球')],
         widget=widgets.RadioSelect
     )
     t5=fields.FileField(
         widget=widgets.FileInput
     )

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类型
     ...

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

　　

3 额外的正则：
          user = fields.CharField(
                             validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')]）

4 页面展示：

 obj = Foo()
         obj = Foo(init..)

         # 灵活
             <form>
                 {{obj.xx}}
                 {{obj.xx}}
                 {{obj.xx}}
                 {{obj.xx}}
             </form>
         # 简单
             {{obj.as_p}}
             <ul>
                 {{obj.as_ul}}
             </ul>
             <table>
                 {{obj.as_table}}
             </table>

5 定制：

class Test1Form(Form):
    user = fields.CharField(validators=[])
    pwd = fields.CharField()

    # 为每个字段定制自己的要求 必须要有返回值
    def clean_user(self):
        v = self.cleaned_data['user']
        if models.Student.objects.filter(name=v).count():
            raise ValidationError('用户名已经存在')
        return self.cleaned_data['user']

    def clean_pwd(self):
        return self.cleaned_data['pwd']

    # 为所有字段定制统一的要求
    def clean(self):
        # user = self.cleaned_data.get('user')
        # email = self.cleaned_data.get('email')
        # if models.Student.objects.filter(user=user,email=email).count():
        #     raise ValidationError('用户名和邮箱联合已经存在')
        return self.cleaned_data

6 自定义验证规则

http://www.cnblogs.com/wupeiqi/articles/6144178.html

转载自：

https://www.cnblogs.com/liuguniang/p/7141837.html