基本使用
from django import forms
class MyForm(forms.Form):
# username字符串类型最小3位最大8位
username = forms.CharField(min_length=3,max_length=8)
# password字符串类型最小3位最大8位
password = forms.CharField(min_length=3,max_length=8)
# email字段必须符合邮箱格式 xxx@xx.com
email = forms.EmailField()
校验数据（可以少传但是不能多传）
"""
1.测试环境的准备 可以自己拷贝代码准备 就是用test.py
2.其实在pycharm里面已经帮你准备一个测试环境
python console
"""
# 这是在 python console 里面运行的
from app01 import views
# 1 将待校验的数据组织成字典的形式传入即可
form_obj = views.MyForm({'username':'tiger', 'password':'123', 'email':'123'})
# 2 判断是否合法 只有在所有的数据都合法的情况下才返回True
form_obj.is_valid()
False
# 3 查看所有校验通过的数据 （清洗过后的数据 也就是合法的数据）
form_obj.cleaned_data
{'username': 'tiger', 'password': '123'}
# 4 查看所有不符合校验规则以及不符合的原因 （不合法的数据 错误的数据）
form_obj.errors
{'email': ['Enter a valid email address.']}
# 5 校验数据直校验类中出现的字段 多传不影响 多传的字段直接忽略
form_obj = views.MyForm({'username':'tiger', 'password':'123', 'email':'123@qq.com', 'hobby': 'study'})
form_obj.is_valid()
True
# 6 校验数据 默认情况下 类里面所有的字段都必须传值
form_obj = views.MyForm({'username':'tiger', 'password':'123'})
form_obj.is_valid()
False
form_obj.errors
{'email': ['This field is required.']}
"""
也就意味着校验数据的时候 默认情况下数据可以多传但是绝不能少传
"""
渲染标签
"""
forms组件只会自动帮你渲染获取用户输入的标签(input select radio checkbox)
不能帮你渲染提交按钮,自己渲染!!!
"""
# 后端
class MyForm(forms.Form):
# username字符串类型最小3位最大8位
username = forms.CharField(min_length=3, max_length=8, label='用户名')
# password字符串类型最小3位最大8位
password = forms.CharField(min_length=3, max_length=8)
# email字段必须符合邮箱格式 xxx@xx.com
email = forms.EmailField()
def index(request):
form_obj = MyForm()
return render(request, 'index.html', locals())
# 前端利用后端生成的空对象做操作
<form action="" method="post">
<p>第一种渲染方式：代码书写极少 封装程度太高 不便于后续的扩展 一般情况下只在本地测试使用</p>
{{ form_obj.as_p }}
{{ form_obj.as_table }}
{{ form_obj.as_ul }}
<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 in form_obj %}
<p>{{ form.label }}:{{ form }}</p> # {{ form }}就相当于是第二种渲染方式里面的{{ form_obj.xxx }}
{% endfor %}
</form>
"""
label属性默认展示的是类中定义的字段首字母大写的形式
也可以自己修改 直接给字段对象加label属性即可
username = forms.CharField(min_length=3,max_length=8,label='用户名')
"""
展示提示信息
"""
浏览器会自动帮你校验数据 但是前端的校验弱不禁风
如何让浏览器不做校验
<form action="" method="post" novalidate>
"""
def index(request):
# 1 先产生一个空对象
form_obj = MyForm()
if request.method == 'POST':
# 获取用户数据并且校验
"""
1.数据获取繁琐
2.校验数据需要构造成字典的格式传入才行
ps:但是request.POST可以看成就是一个字典
"""
# 3.校验数据
form_obj = MyForm(request.POST)
# 4.判断数据是否合法
if form_obj.is_valid():
# 5.如果合法 操作数据库存储数据
return HttpResponse('OK')
# 5.不合法 有错误
# 2 直接将该空对象传递给html页面
return render(request,'index.html',locals())
{% for form in form_obj %}
<p>
{{ form.label }}:{{ form }}
<span style="color: red">{{ form.errors.0 }}</span>
</p>
{% endfor %}
"""
1.必备的条件 get请求和post传给html页面对象变量名必须一样
就是 form_obj = MyForm() form_obj = MyForm(request.POST) 变量名必须一样
2.forms组件当你的数据不合法的情况下 会保存你上次的数据 让你基于之前的结果进行修改
更加的人性化
"""
# 针对错误的提示信息还可以自己自定制
class MyForm(forms.Form):
# username字符串类型最小3位最大8位
username = forms.CharField(min_length=3,max_length=8,label='用户名',
error_messages={
'min_length':'用户名最少3位',
'max_length':'用户名最大8位',
'required':"用户名不能为空"
}
)
# password字符串类型最小3位最大8位
password = forms.CharField(min_length=3,max_length=8,label='密码',
error_messages={
'min_length': '密码最少3位',
'max_length': '密码最大8位',
'required': "密码不能为空"
}
)
# email字段必须符合邮箱格式 xxx@xx.com
email = forms.EmailField(label='邮箱',
error_messages={
'invalid':'邮箱格式不正确',
'required': "邮箱不能为空"
}
)
钩子函数(HOOK)(第二道关卡校验)
"""
在特定的节点自动触发完成响应操作
钩子函数在forms组件中就类似于第二道关卡，能够让我们自定义校验规则
在forms组件中有两类钩子
1.局部钩子
当你需要给单个字段增加校验规则的时候可以使用
2.全局钩子
当你需要给多个字段增加校验规则的时候可以使用
"""
# 实际案例
# 1.校验用户名中不能含有666 只是校验username字段 局部钩子
# 2.校验密码和确认密码是否一致 password confirm两个字段 全局钩子
# 钩子函数
# 局部钩子
def clean_username(self):
# 获取用户名
username = self.cleaned_data.get('username') # MyForm.cleaned_data
if '666' in username:
# 提示前端展示报错信息
self.add_error('username', '不可以说666哦~') # add_error(字段名，报错信息)
# 将钩子函数钩出来的数据再放回去
return username
# 全局钩子
def clean(self):
password = self.cleaned_data.get('password')
confirm_password = self.cleaned_data.get('confirm_password')
if not confirm_password == password:
self.add_error('confirm_password', '两次密码不一致！')
# 将钩子函数钩出来的数据再放回去
return self.cleaned_data
label 字段名
error_messages 自定义报错信息
initial 默认值 相当于default设置个默认值
required 控制字段是否必填
"""
1.字段没有样式
2.针对不同类型的input如何修改
text
password
date
radio
checkbox
...
"""
"""
因为前端代码是直接用的 第三种渲染方式渲染的{{ form.label }}:{{ form }}
不是个标签 所以你想加bootstrap加不了 input框中的type类型也没法修改
所以就要运用到一个新参数 widget
EmailInput ----> type="email"
TextInput ----> type="text"
PasswordInput ---> type="password"
...
这些参数就是设置type类型的
在后面的括号中可以通过 attr={} 来添加属性 加class、id等等 这样在class里面就能用bootstrap了
"""
widget=forms.widgets.PasswordInput(attrs={'class':'form-control c1 c2'}) # 多个属性值 直接空格隔开即可
# 第一道关卡里面还支持正则校验 RegexValidator验证器
from django.core.validators import RegexValidator
phone = forms.CharField(validators=[
RegexValidator(r'^[0-9]+$', '请输入数字'),
RegexValidator(r'^139[0-9]+$', '数字必须以139开头')])
其他类型渲染(选择框类的)
"""
只要是选择框类的
都是forms.ChoiceField
通过widget参数修改选择框类型
"""
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()
)
浙公网安备 33010602011771号