Django Form 表单

Django Form 表单

form 表单
Form表单验证（用户请求验证+生成HTML标签）
表单验证

 示例：用户管理
      a. 添加用户页面
         - 显示HTML标签
         - 提交：数据验证
         - 成功之后保存
         - 错误显示错误信息

创建自定义类，继承Form ， 类属性 最好与数据库 列名相同:

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

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')

如果需要读库的内容，则应该放入 类初始化方法中，不然数据库有更新，却更新不到页面，
因为类属性 只有在第一次生成的时候执行，而 初始化方法 在每次类被调用的时候都执行，能拿到第一手资料

注册：

1. 用户名，密码 电话，地址，邮箱 不能为空
2. 符合一些格式的规范， 电话号码，多少位数， 邮箱xxx@.com
3. 自定义验证方式， 密码，确认密码 要一致 等等

views.py

#使用表单必须导入这3个函数
form django.forms import Form      # 继承类的时候 需要用到 
form django.forms import fields    #
form django.forms import widgets 


class RegisterForm(Form):        # TextInput 和 PasswordInput 是系统定义好的
    username = fields.CharField(
            required = True,   #以下的都是验证的规则
            min_length=4,    #输入的最小字节数
            max_length=8,   #输入的最大字节数
            error_messages = {'required':'用户名不能为空'}   # 报错信息
            widget = widget.TextInput(attrs={'class':'c1'})  # 这就是前端的输入框
           )              # attrs={'class':'c1'}  前端的class, 前端样式的接口
   
    password = fields.CharField(
            min_length=6,    #输入的最小字节数
            max_length=12,   #输入的最大字节数
            error_messages = {'required':'密码不能为空'}        # 报错返回的信息
            widget = widget.PasswordInput(attr={'class':'c1'})   # 密码的输入框
           )
    pwd_again = fields.CharField(
            min_length=6,    #输入的最小字节数
            max_length=12,   #输入的最大字节数
            error_messages = {'required':'确认密码不能为空'}
            widget = widget.PasswordInput(attr={'class':'c1'})   # 确认密码的输入框
           )
     
    def clean(self):
        try:
            pwd = self.cleaned_data['password']  # 取到密码信息
            pwd_again = self.cleaned_data['pwd_again']   #取到 确认密码的信息
            if pwd == pwd_again:  
                del self.cleaned_data['pwd_again']  
                 # 如果数据库里 没有这个字段，不删除这个信息就会报错         
                return self.cleaned_data        # 一样的 则正确返回
            else:
                from django.core.exceptions import ValidationError  
                # 如果不对加载内置模块
                #self.add_error('pwd_again',ValidationError('密码输入不一致'))
                #返回错误信息
                return self.cleaned_data
        except KeyError as e:
                return self.cleaned_data
        


def register(request):
    if request.method == 'GET':
        form = RegisterForm()   #实例化RegisterForm类
        return render(request,'register.html',{'form':form})
    else:
        form = RegisterForm(request.POST)
        if form.is_valid():  # is_valid() 判断是否符合 实例化类的 规则
            models.UserInfo.object.create(**form.cleaned_data) 
            # 以字典方式可以多个创建用户信息
            # ( **form.cleaned_data )  里面有所有的POST信息
            #print (form.cleaned_data['password'])         # 这是个 QueryDict 
            #print (form.cleaned_data['pwd_again'])
            return HttpResponse('注册成功')
        else:
            print (form.errors)   
           # 如何没通过验证，则会在errors 里面加了一些错误信息。然后返回前端显示
        return render(request, 'register.html',{'form':form})

tmeplate
register.html

<form method='POST' novalidate>
    {% csrf_token %}
    <p> 用户名:  {{form.username}} {{form.errors.username.0}} </p>
    <p> 密码:    {{form.password}}  {{form.errors.password.0}} </p>
    <p> 确认密码: {{form.pwd_again}}  {{form.error.pwd_again.0}} </p>
    <input type='submit' vlaue='提交' />
</form>

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