day 56 forms组件

01. forms组件作用

渲染标签
校验数据
保留信息

02. 使用forms组件的前提

提前写好一个类

from django import forms
class MyForm(forms.Form):
  name = forms.CharField(label='用户名')
  pwd = forms.CharField(label='密码')

03. forms组件的使用

校验数据

def register(request):
    forms_obj = MyForms() # 为get请求渲染前端页面用
    if request.method == 'POST':
        forms_obj = MyForms(request.POST) # 将POST这个字典直接传给类
        if forms_obj.is_valid(): # 判断是否符合校验规格
            return HttpResponse('数据全部正确')
    return render(request, 'register.html', {'forms': forms_obj})

向forms对象传入一个字典，key为字段名（可以多传，不能少传）
判断是否符合is_valid
查看不符合要求的字段errors
如何查看符合校验规则的数据cleaned_data

渲染前端标签

生成一个空的forms组件对象
直接将该对象传入前端

前端渲染

obj.as_标签：封装程度高，不推荐项目中使用，适用于本地测试

{{ form_obj.as_p }}
{{ form_obj.as_ul }}
{{ form_obj.as_table }}  <!--会自动渲染出input框-->

obj.字段名.lable、obj.字段名。手动将其解耦

{{ form_obj.username.label }}{{ form_obj.username }}
{{ form_obj.password.label }}{{ form_obj.password }}

使用for循环

<form action="" method="post" novalidate>
    {% for form in forms %}
        <p>{{ form.label }}:{{ form }}{{ form.errors.0 }}</p>
    {% endfor %}
    <input type="submit">
</form>

如何告诉浏览器不做校验novalidate
```
<form action="" method="post" novalidate>
```
前端展示错误信息
```
<span>{{ form.errors.0 }}</span>
```

字段校验

内置校验器RegexValidator（正则校验）

from django.core.validators import RegexValidator

validators=[
  RegexValidator(r'^\d+$','请输入数字'),
                               ]

钩子函数HOOK

当内置的校验无法满足需求时

局部钩子

# 用于校验单独字段
def clean_username(self):
    value = self.cleaned_data.get('username')
    if 'i' in value:
        self.add_error('username','包含非法字符')
    return self.cleaned_data

全局钩子

# 用于多个字段联合校验
def clean(self):
    password_value = self.cleaned_data.get('password')
    re_value = self.cleaned_data.get('re_pwd')
    if re_value != password_value:
        self.add_error('re_pwd','密码不一致')
    return self.cleaned_data

字段及参数

参数

label

# 解释性说明,默认字段名
label = '用户名' # 设定
obj.username.label # 调用

initial
```
# input框默认值
initial='123456' 
```

error_messages

# 重写错误信息
error_messages={
     'required': '不能为空',
     'min_length':'太短了不好',
     'max_length':'太长了不好'}

widget

# 用来修改input框样式
widget= forms.widgets.input类型({'属性名':'属性值',})

password

# input框的password模式 
widget=forms.widgets.PasswordInput({'class':'form-control c1 c2','username':'jason'})

required

# 设置字段是否可以为空
required=False # 默认为True不可为空

字段

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

day 56 forms组件

day 56 forms组件

01. forms组件作用

02. 使用forms组件的前提

03. forms组件的使用

猜你喜欢