一.Form简介
1.form组件的主要功能
1.生成页面可用的HTML标签 2.对用户提交的数据进行校验 3.保留上次输入内容
2.页面显示的步骤
1.views.py中导入forms模块:from django import froms 2.定义继承自forms.Form的类,类中定义字段(和models中的写法相同) 3.视图函数中创建该类的对象 4.如果是get请求，向页面中渲染form对象。
3.简单使用form组件实现的例子
class Regform(forms.Form): # 查看所有字段(forms->fields->查看__all__) """ CharField对应input标签，users、pwd是input标签中的name的值，label对应label标签，widget的值对应input标签的类型 ChoiceField对应select标签,choices中的选项是option的值 """ users = forms.CharField(label="用户名", widget=forms.TextInput) pwd = forms.CharField(label="密码", widget=forms.PasswordInput) choice = forms.ChoiceField(label="性别", choices=((1, "alex"), (2, "egon"))) def form_test(req): form_obj = Regform() # 实例化Regform对象 if req.method == "POST": form_obj = Regform(data=req.POST) if form_obj.is_valid(): # is_valid()是遍历所有提交过来的字段的值是否合法 if req.POST.get("password") != req.POST.get("re_password"): return render(req, "form_test.html", {"form_obj": form_obj}) # 此处保留在前端界面上的数据 else: return redirect("/index/") return render(req, "form_test.html", {"form_obj": form_obj}) # 将form_obj渲染给前端界面
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <form action="/form_test/" method="post"> {% csrf_token %} {{ form_obj.as_p }} #生成所有标签，将生成的标签用p标签包起来 #{{ form_obj.as_table }} #用table标签包裹 #{{ form_obj.as_ul }} #用ul表标签包裹 <p> <label for="{{ form_obj.users.id_for_label }}">{{ form_obj.users.label }}</label>: {{ form_obj.users }}{{ form_obj.users.errors }} #errors是这个字段的所有出现的错误,errors.0是出现的错误的第一条 </p> <p> <label for="{{ form_obj.pwd.id_for_label }}">{{ form_obj.pwd.label }}</label> {{ form_obj.pwd }}{{ form_obj.pwd.errors }} </p> <p> <label for="{{ form_obj.choice.id_for_label }}">{{ form_obj.choice.label }}</label> {{ form_obj.choice }}{{ form_obj.choice }} </p> <input type="submit"> </form> </body> </html>
# print(status) # print(obj.errors.as_json) #拿到错误信息 #平常使用 obj=FormData(req.POST) if obj.is_valid(): #is_valid() for循环遍历FormData中所有字段，如果所有字段都合法，返回true，如果有一个不合法，返回false print(obj.clean()) #输出拿到的正确信息 else: print(obj.errors.as_json)#如果验证错误输出错误信息 u=obj.errors['username'][0] #拿到错误值(含标签) #u=obj.errors['username'] #拿到错误的文本值 e=obj.errors["email"][0]
二.Form常用字段和插件
initial
初始值，input框的初始值
class LoginForm(forms.Form):
username = forms.CharField(
min_length=8,
label="用户名",
initial="张三",
)
error_messages
重写错误信息
class LoginForm(forms.Form):
username = forms.CharField(
min_length=8,
label="用户名",
initial="张三",
error_messages={
"required":"不能为空", #验证前端中username字段是否为空，为空再提示
"invalid":"格式错误", #格式错误，正则校验错误
"min_length":"用户名最短8位"
}
)
password
class LoginForm(forms.Form):
pwd = forms.CharField(
min_length=6,
label="密码",
widget=forms.PasswordInput(attrs={'class': 'c1'}, render_value=True) #这个密码字段和其他字段不一样，默认在前端输入数据错误的时候，点击提交之后，默认是不保存的原来数据的，但是可以通过这个render_value=True让这个字段在前端保留用户输入的数据
)
radioSelect
class LoginForm(forms.Form):
gender = forms.ChoiceField(
choices=((1,"男"),(2,"女")),
label="性别",
initial=2,
widget=forms.RadioSelect()
)
单选Select
class LoginForm(forms.Form):
hobby = forms.ChoiceField(
choices=((1,"篮球"),(2,"足球"),(3,"双色球")),
label="爱好",
initial=3,
widget=forms.Select()
)
多选Select
class LoginForm(forms.Form):
hobby2 = forms.MultipleChoiceField(
choices=((1,"篮球"),(2,"足球"),(3,"双色球")),
label="爱好2",
initial=[1,3],
)
单选checkbox
class LoginForm(forms.Form):
keep = forms.ChoiceField(
choices=(("True",1),("False",0)),
label="是否7天内自动登录",
initial="1", #????
widget=forms.CheckboxInput,
)
多选checkbox
class LoginForm(forms.Form):
hobby = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
label="爱好",
initial=[1, 3],
widget=forms.widgets.CheckboxSelectMultiple()
)
date类型
class LoginForm(forms.Form):
date = forms.DateField(
widget=forms.TextInput(attrs={"type":"date"}) #必须指定type
)
emailField
email = forms.EmailField(label="邮箱", #EmailField
widget=forms.EmailInput(attrs={"name":"email","placeholder":"邮箱"}), #EmailInput
error_messages={
"required":"不能为空",
"invalid": "格式错误", #验证格式
})
choice字段注意事项
通过重构方法对choice进行实时更新
class LoginForm(forms.Form):
city = forms.ChoiceField(
initial=2,
widget=forms.Select
)
def __init__(self,*args,**kwargs):
super(LoginForm,self).__init__(*args,**kwargs) #参数必须写
self.fields['city'].choices=models.City.objects.all().values_list("id","name") #values_list返回[(),()]类型
通过init给字段设置属性值
#通过init方法给所有字段设置属性
def __init__(self,*args,**kwargs):
super().__init__(*args,**kwargs)
print(self.fields)
for filed in self.fields.values():
#设置单个属性值
self.fields["password"].widget.attrs={"class":"form-control"}
#设置多个属性值
filed.widget.attrs.update({"class":"form-control"})
# filed.widget.attrs={"class":"form-control"}
三.Form中内置字段
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类型 复制代码
四.字段校验
1.RegexValidator验证器
from django import forms
from django.forms import widgets
from django.forms import fields
from django.core.validators import RegexValidator
class Regexsform(forms.Form):
user = forms.IntegerField(
validators=[RegexValidator(r'^[0-9]+$'),"请输入数字",
RegexValidator(r"^159[0-9]+$"),"数字必须以159开头"]
)
2.自定义验证函数
def mobile_validate(value): #phone字段用此验证，就将phone字段得到的值传参给value
if "alex" in value:
raise ValidationError("错误") #必须自己指定错误
class Regexsform(forms.Form):
phone = forms.CharField(validators=[mobile_validate,],
label="ppp",
error_messages={
'required':"手机号不能为空"
},
widget=forms.TextInput(attrs={
"class":"form-control",
"placeholder":u"手机号码"
})
)
五.Hook钩子方法
在Form中定义钩子方法，也是实现自定义的验证功能
执行顺序：自己先前定义的的校验-->局部钩子-->全局钩子
1.局部钩子
Fom类中定义 clean_字段名() 方法，就能够实现对特定字段进行校验
class LoginForm(forms.Form):
username = forms.CharField(
min_length=8,
label="用户名",
initial="张三",
error_messages={
"required": "不能为空",
"invalid": "格式错误",
"min_length": "用户名最短8位"
},
widget=forms.widgets.TextInput(attrs={"class": "form-control"})
)
...
# 定义局部钩子，用来校验username字段,之前的校验股则还在，给你提供了一个添加一些校验功能的钩子
def clean_username(self):
value = self.cleaned_data.get("username") #cleaned_data是上面所有通过验证的字段
if "666" in value:
raise ValidationError("光喊666是不行的")
else:
return value
2.全局钩子
我们在Fom类中定义 clean() 方法，就能够实现对字段进行全局校验，字段全部验证完，局部钩子也全部执行完之后，执行这个全局钩子校验.
class LoginForm(forms.Form):
...
password = forms.CharField(
min_length=6,
label="密码",
widget=forms.widgets.PasswordInput(attrs={'class': 'form-control'}, render_value=True)
)
re_password = forms.CharField(
min_length=6,
label="确认密码",
widget=forms.widgets.PasswordInput(attrs={'class': 'form-control'}, render_value=True)
)
...
# 定义全局的钩子，用来校验密码和确认密码字段是否相同，执行全局钩子的时候，cleaned_data里面肯定是有了通过前面验证的所有数据
def clean(self):
password_value = self.cleaned_data.get('password')
re_password_value = self.cleaned_data.get('re_password')
if password_value == re_password_value:
return self.cleaned_data #全局钩子要返回所有的数据
else:
self.add_error('re_password', '两次密码不一致') #在re_password这个字段的错误列表中加上一个错误，并且clean_data里面会自动清除这个re_password的值，所以打印clean_data的时候会看不到它
raise ValidationError('两次密码不一致')
六.ModelForm
1.ModelForm认识
这个组件的功能就是把model和form组合起来，假如我们有个model模型Student类，想通过前端处理一些字段的验证，有3种方式：
1.自己手写前端界面中的标签，然后自己写一些验证
2.通过Form组件(需要将要验证的字段重写)
3.以上两种方式都跟model模型没有耦合性，都需要自己一个个配对，现在通过ModelForm可以实现耦合，取出model模型中的任意字段进行验证，这样不用再像form组件那样再重写字段
①首先在视图函数中导入ModelForm
from django.forms import ModelForm
②定义一个类，就叫StudentList，继承自ModelForm
class StudentList(ModelForm):
class Meta: # 想要验证的字段都写在Meta类中
model = models.Student # 对应model中的Student类
fields = "__all__" # 字段，如果是all，就列出所有字段
exclude = None # 排除的字段 exclude = ["name","age"]
help_texts = None # 帮助信息 help_texts = ["name","age"]
from django.forms import widgets as wig # 因为重名，起个别名
widgets = { # 设置字段的类型
"name": wig.Textarea(attrs={"class": "c1"})
}
error_messages = {
"name": {"required": "用户名不能为空"},
"age": {"required": "年龄不能为空"},
}
labels = {"name": "用户名", "age": "年龄"} # 自定义在前端显示的名字
③在url对应的视图函数中实例化此类，并将对象传给前端
def modelfrom(req):
if req.method == "GET":
student_list = StudentList()
return render(req,"studentlist.html",{"student_list":student_list})
else:
student_list = StudentList(req.POST)
if student_list.is_valid():
student_list.save() #提交post请求时，只需要.save()就能保存所有提交的数据
return render(req,"studentlist.html",{"student_list":student_list})
④前端只需要{{student_list.as_p}}，所有的字段就能显示，或者for循环遍历student_list，写法和form表单中略有不同，详见下：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<form action="/modelform/" method="post" novalidate>
{% csrf_token %}
{# {{ student_list.as_p }}#}
{% for i in student_list %}
<label for="{{ i.id_for_label }}">{{ i.label }}</label>
{{ i }}
{% endfor %}
<input type="submit">
</form>
</body>
</html>
2.编辑(添加)数据
只需要加一个instance=obj(obj是model模型中的类实例化的一条对象)，前端界面和上④中相同即可
obj = models.Student.objects.filter(pk=1)[0]
if req.method == "GET":
student_list = StudentList(instance=obj) #此处obj为要显示在前端的数据
return render(req,"student_edit.html",{"student_list":student_list})
else:
student_list = StudentList(req.POST,instance=obj)
if student_list.is_valid():
student_list.save() #不加instance为添加记录，如果加上为更新obj的内容
return redirect("/modelform_edit/")
3.其他
外键相关(在model模型中有外键Foreignkey，modelform会生成其对应的所有字段，想解决此种方式，就要修改queryset)
model模型
def __init__(self,req,*args,**kwargs):
super().__init__(*args,**kwargs)
for ids,filed in self.fields.items():
if ids == "consultant":
filed.queryset = models.UserInfo.objects.filter(username=req.username) #设置字段名为consultant的外键关联数据
filed.widget.attrs.update({"class": "form-control"})
MultiSelectField
from multiselectfield import MultiSelectField #要使用需安装django-multiselectfield模块
class Customer(models.Model):
"""客户表"""
course = MultiSelectField("咨询课程",choices=course_choices) #多选，modelform生成多选框，如下图
此处如果给控件添加bootstrap样式，生成如下混乱状态：
解决方式：
def __init__(self,*args,**kwargs):
super().__init__(*args,**kwargs)
for filed in self.fields.values():
print(type(filed))
if not isinstance(filed,MultiSelectFormField):
filed.widget.attrs.update({"class": "form-control"})
七.modelformset_factory
工厂模式用来生成如下效果(主要用来批量编辑使用):
views视图函数
from app01 import models
class StudyForms(ModelForm):
class Meta:
model = models.StudyRecord
fields = "__all__"
from django.forms.models import modelformset_factory
class StudyRecordView(views.View):
def get(self,req): #get请求，用来将后台数据显示到前端界面，如上图
pk = req.GET.get("pk")
formset_obj = modelformset_factory(models.StudyRecord,myforms.StudyForms,extra=0) #models模型中的StudyRecord类，自定义的modelform对象
#formset_obj = formset_obj(queryset=models.StudyRecord.objects.filter(course_record__id=pk)) #设置前端显示的数据，不写的话显示所有
return render(req,"course_record/studyrecord_list.html",{"formset_obj":formset_obj})
def post(self,req): #post请求，用来接受前端发来的数据
print(req.get_full_path())
formset_obj = modelformset_factory(models.StudyRecord,myforms.StudyForms,extra=0)
formset_obj = formset_obj(req.POST)
if formset_obj.is_valid():
formset_obj.save() #更新数据库
return redirect(req.get_full_path())
else:
return render(req,"course_record/studyrecord_list.html",{"formset_obj":formset_obj})
html界面
<tbody>
{% for f_obj in formset_obj %}
<tr role="row" class="odd">
{{ f_obj.id }}
<td>
<input type="checkbox" name="cids" value={{ f_obj.pk }}>
</td>
<td>{{ forloop.counter }}</td>
<td>{{ f_obj.attendance }}</td>
<td>{{ f_obj.score }}</td>
<td>{{ f_obj.homework_note }}</td>
<td class="hidden">{{ f_obj.course_record }}</td> #post请求时，会将所有f_obj的数据发送到后端，除了f_obj.instance..xx,此处用来在前端界面显示
<td>{{ f_obj.instance.course_record }}</td>
<td class="hidden">{{ f_obj.student.name }}</td>
<td>{{ f_obj.instance.student }}</td>
</tr>
{% endfor %}
</tbody>