第六章、forms组件
目录
第六章、forms组件
一、注册功能手写
要求
1.注册功能
用户输入的用户名中 不能包含西游记
如果包含了 就提示用户 输入的内容不符合社会主义核心价值观
用户输入的密码 不能小于三位
如果密码少于三位 提示用户 密码太短了
说明(******)
校验数据通常是前后端都有校验
但是前端校验可有可无 哪怕再牛逼
后端也必须要有校验 反正一句话 前端可有不校验 后端必须校验!!!
分析
1.搭建前端页面 >>> 渲染页面
2.获取前端用户提交的数据校验 >>> 校验数据
3.对数据的校验的结果 展示到前端页面给用户查看 >>> 展示错误信息
前端代码
#reg.html部分代码
<form action="" method="post">
<p>username:
<input type="text" name="username">
<span style="color: red">{{ back_dic.username }}</span>
</p>
<p>password:<input type="text" name="password">
<span style="color: red">{{ back_dic.password }}</span>
</p>
<input type="submit">
</form>
后端代码
def reg(request):
back_dic = {"username":'','password':''}
if request.method == 'POST':
username = request.POST.get('username')
password = request.POST.get('password')
if '西游记' in username:
# 提示信息
back_dic['username'] = '不符合社会主义核心价值观'
if len(password) < 3:
# 提示信息
back_dic['password'] = '密码不能少于三位'
return render(request,'reg.html',locals())
二、forms组件完整写法
写法和写模型表类极其相似,但是 forms 组件的字段有约束,模型表类的字段没有约束
from django import forms
from django.forms import widgets # 当你forms点不出来的时候 你可以手动导入一下
from django.core.validators import RegexValidator
class MyRegForm(forms.Form):#写一个继承了 forms.Form 的类
username = forms.CharField(min_length=3,max_length=8,label='用户名', # 用户名最长八位最短三位
error_messages={
'min_length':'用户名最短三位',
'max_length':'用户名最长八位',
'required':'用户名不能为空'
},initial='我是初始值',required=False,#允许不填
widget= widgets.TextInput(attrs={'class':'form-control others'})
)
password = forms.CharField(min_length=3,max_length=8,label='密码',error_messages={
'min_length':'密码最短三位',
'max_length':'密码最长八位',
'required':'密码不能为空'
},widget=widgets.PasswordInput())
confirm_password = forms.CharField(min_length=3, max_length=8, label='确认密码', error_messages={
'min_length': '确认密码最短三位',
'max_length': '确认密码最长八位',
'required': '确认密码不能为空'
})
email = forms.EmailField(label='邮箱',error_messages={
'required':'邮箱不能为空',
'invalid':'邮箱格式不正确'
},required=False,widget=widgets.EmailInput(attrs={'class':'form-control'}))
基本使用
-
将需要校验的数据,以字典(一般是直接 request.POST 当参数(是一个大字典))的方式传递给自定义的类,实例化产生对象
form_obj = views.LoginForm({'username':'jason','password':'123','email':'123'})
-
如何查看数据是否全部合法
form_obj.is_valid() ,只有所有的数据都符合要求 才会是True
-
如何查看错误原因
form_obj.errors 结果: 'password': ['Ensure this value has at least 5 characters (it has 3).'], 'email': ['Enter a valid email address.']
-
如何查看校验通过的数据
form_obj.cleaned_data 结果: {'username': 'jason'}
三、forms组件前端渲染标签组件
说明:forms组件只会帮你渲染获取用户输入(输入,选择,下拉框...)的标签 提交按钮需要你自己手动写
前提步骤:
先生成一个空对象,并将对象传递给前端页面 form_obj = MyForm()
,然后选一种方式渲染
#后端
def formmm(request):
# 1.生成一个空的对象
form_obj = MyRegForm()
if request.method == 'POST':
# 2.获取用户提交的数据
# print(request.POST) # request.POST 其实也可以看成是一个字典
# 3.借助于form组件帮助我们校验
form_obj = MyRegForm(request.POST) # 由于request.POST其实就是一个大字典 所以直接当做参数传入即可
# 4.判断用户输入的数据是否符合校验规则
if form_obj.is_valid():
return HttpResponse('你上传的数据没有问题')
return render(request,'formmm.html',locals())
渲染页面(推荐第三种)
<p>第一种渲染页面的方式(封装程度太高 一般只用于本地测试 通常不适用)</p>
{{ form_obj.as_p }}
{{ form_obj.as_ul }}
{{ form_obj.as_table }}
<p>第二种渲染页面的方式(可扩展性较高 一个一个字段地写,书写麻烦)</p>
<p>{{ form_obj.username.label }}{{ form_obj.username }}</p>
<p>{{ form_obj.password.label }}{{ form_obj.password }}</p>
<p>{{ form_obj.email.label }}{{ form_obj.email }}</p>
<p>第三种渲染页面的方式(推荐,无论有多少个字段都只需要这几个)</p>
{% for form_field in form_obj %}
<p>{{ form_field.label }}{{ form_field }}</p>
{% endfor %}
展示错误信息
默认是 ul 套 li ,可能有多个报错,我们索引取 0,取消它的 ul li 标签嵌套
<p>第三种渲染前端页面的方式:代码量和扩展性都很高(推荐使用)</p>
<form action="" method="post">
{% for foo in form_obj %}
<p>
{{ foo.label }}:{{ foo }}
<span style="color: red">{{ foo.errors.0 }}</span>
</p>
{% endfor %}
<input type="submit">
</form>
取消展示错误信息
只要加一参数novalidate
<form action="" method="post" novalidate>
注意事项
- forms 组件在帮你渲染页面的时候 只会渲染获取用户输入的标签 提交按钮需要你手动添加
- input 框的 label 注释 不指定的情况下 默认用的是类中字段,并且首字母大写
三、forms组件其他知识点
在python console测试
类似于django的测试环境
校验数据
form对象实例化参数是一个大字典
from app01 import views
# 1.给自定义的类传一个字典
obj = views.MyRegForm({'username':'jason','password':'12','email':'123'})
# 2.判断数据是否全部合法
obj.is_valid() # 只有数据全部符合要求才会是True
Out[4]: False
# 3.查看符合校验规则的数据
obj.cleaned_data
Out[5]: {'username': 'jason'}
# 4.查看不符合条件的数据以及不符合的原因是什么
obj.errors
Out[6]:
{
'password': ['Ensure this value has at least 3 characters (it has 2).'],
'email': ['Enter a valid email address.']
}
# 5.校验数据的时候 默认情况下类里面所有的字段都必须传值
obj = views.MyRegForm({'username':'jason','password':'123'})
obj.is_valid()
Out[12]: False
obj.errors
Out[13]: {'email': ['This field is required.']}
# 6.默认情况下可以多传 但是绝对不能少传
obj = views.MyRegForm({'username':'jason','password':'1233','email':'123@qq.com','xxx':'ooo'})
obj.is_valid()
Out[15]: True
form组件数据校验的规则
- 从上往下依次取值校验
- 校验通过的放到 cleaned_data
- 校验失败的放到 errors
注意:
form 中所有的字段默认都是必须传值的(默认:required=True)
只要有一个字段不通过,form_obj.is_valid() 的结果就是 False,所有字段都校验通过了才会返回 True
校验数据的时候可以多传(多传的数据不会做任何的校验 >> > 不会影响 form 校验规则(所以 可以传 request.POST 直接当做参数,多余的不管))
四、其他几个常见字段类型
# 单选的radio框
gender = forms.ChoiceField(
choices=((1, "男"), (2, "女"), (3, "保密")),
label="性别",
initial=3,
widget=forms.widgets.RadioSelect()
)
# 单选select
hobby = forms.ChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
label="爱好",
initial=3,
widget=forms.widgets.Select()
)
# 多选的select框
hobby1 = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
label="爱好",
initial=[1, 3],
widget=forms.widgets.SelectMultiple()
)
# 单选的checkbox
keep = forms.ChoiceField(
label="是否记住密码",
initial="checked",
widget=forms.widgets.CheckboxInput()
)
# 多选的checkbox
hobby2 = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
label="爱好",
initial=[1, 3],
widget=forms.widgets.CheckboxSelectMultiple()
)
phone = forms.CharField(
validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
)
五、forms组件所有内置字段类型
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类型
六、forms组件的字段常见参数
# 基本都渲染成 HTML 标签的属性(H5 对这些属性有支持)
max_length 最大长度
min_length 最小长度
required 是否必填
label 注释信息
initial 初始值(对应的是 value)
error_messages 报错信息
widget 控制标签的属性和样式(要手动导入,如果 forms.widget 点不出来 Widget,可以先导入 from django.forms import widget(有时候点不出来就需要自己写))
validators 正则(要手动导入,相当于钩子函数)
。。。
用正则来约束
#每个字段 还支持正则校验
from django import forms
from django.forms import Form
from django.core.validators import RegexValidator
class MyForm(Form):
user = forms.CharField(
validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
)
七、forms组件钩子函数
含义:对通过基本校验(包含正则校验)的 forms 字段再进行额外的自定义校验(定制化业务需求)
-
基本步骤
- 在 cleaned_data 里面获取字段
self.cleaned_data.get('字段名')
- 对获取的字段进行自定义校验
if not password == confirm_password:
- 不符合的
self.add_error('字段名', '报错提示信息')
- return 一个返回值
return self.cleaned_data/username...
- 在 cleaned_data 里面获取字段
-
局部钩子
# 当你需要对某一个字段数据进行额外的一些列校验 你可以考虑使用钩子函数 # 针对单个字段的 使用局部钩子 #函数名:clean_formsField def clean_username(self): username = self.cleaned_data.get('username') if '西游记' in username: # 给username字段下面提示错误信息 self.add_error('username','用户名不符合社会主义核心价值观') return username #针对某一个字段作额外校验(一定要返回该字段的值)
-
全局钩子
# 针对多个字段的校验 使用全局钩子 eg:校验两次密码是否一致 def clean(self): password = self.cleaned_data.get('password') confirm_password = self.cleaned_data.get('confirm_password') if not password == confirm_password: self.add_error('confirm_password','两次密码不一致') return self.cleaned_data
八、通过后端修改前端的样式
如何改变input框的type属性值
widget= widgets.TextInput()
widget=widgets.PasswordInput()
如何让forms组件渲染出来的input框有form-control类属性
widget= widgets.TextInput(attrs={'class':'form-control others'}) # 如果有多个类属性 空格隔开
widget=widgets.PasswordInput(attrs={'class':'form-control others'})
说明:详情写法见第二个大纲