1. 概述
Django的Form组件一般功能有：
- 验证用户输入
- 生成html代码
- 返回错误信息
创建Form类
from django.shortcuts import render, redirect
from django import forms
from django.forms import fields
class F1Form(forms.Form):
user = fields.CharField(
max_length=18,
min_length=6,
required=True,
error_messages={
'required': '不能为空',
'min_length': '太短了',
'max_length': '太长了',
'invalid': '输入格式错误'
}
)
pwd = fields.CharField(
min_length=8,
max_length=16,
required=True,
error_messages={
'required': '不能为空',
'min_length': '太短了',
'max_length': '太长了',
'invalid': '输入格式错误'
}
)
age = fields.IntegerField(
required=True,
error_messages={
'required': '不能为空',
'invalid': '输入格式错误'
}
)
email = fields.EmailField(
required=True,
error_messages={
'required': '不能为空',
'invalid': '输入格式错误'
}
)
view函数
def f1(request):
if request.method == 'GET':
obj = F1Form()
return render(request, 'f1.html', {'obj': obj})
else:
# user = request.POST.get('user')
# pwd = request.POST.get('pwd')
# age = request.POST.get('age')
# email = request.POST.get('email')
obj = F1Form(request.POST)
# 验证输入
if obj.is_valid():
print('验证成功', obj.cleaned_data)
return redirect('/f1')
else:
print('验证失败', obj.errors)
return render(request, 'f1.html', {'obj': obj})
生成HTML代码
<!DOCTYPE html>
{% load staticfiles %}
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<form action="/f1" method="post">
<p>{{ obj.user }}{{ obj.user.errors.0 }}</p>
<p>{{ obj.pwd }}{{ obj.pwd.errors.0}}</p>
<p>{{ obj.age }}{{ obj.age.errors.0 }}</p>
<p>{{ obj.email }}{{ obj.email.errors.0 }}</p>
<input type="submit" value="提交">
</form>
</body>
</html>
2. Form的字段
用于保存正则表达式
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类型
...
3. HTML插件
用于生成HTML标签（只能是form表单类的）
TextInput(Input) NumberInput(TextInput) EmailInput(TextInput) URLInput(TextInput) PasswordInput(TextInput) HiddenInput(TextInput) Textarea(Widget) DateInput(DateTimeBaseInput) DateTimeInput(DateTimeBaseInput) TimeInput(DateTimeBaseInput) CheckboxInput Select NullBooleanSelect SelectMultiple RadioSelect CheckboxSelectMultiple FileInput ClearableFileInput MultipleHiddenInput SplitDateTimeWidget SplitHiddenDateTimeWidget SelectDateWidget
常用插件
# 单radio，值为字符串 # user = fields.CharField( # initial=2, # widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),)) # ) # 单radio，值为字符串 # user = fields.ChoiceField( # choices=((1, '上海'), (2, '北京'),), # initial=2, # widget=widgets.RadioSelect # ) # 单select，值为字符串 # user = fields.CharField( # initial=2, # widget=widgets.Select(choices=((1,'上海'),(2,'北京'),)) # ) # 单select，值为字符串 # user = fields.ChoiceField( # choices=((1, '上海'), (2, '北京'),), # initial=2, # widget=widgets.Select # ) # 多选select，值为列表 # user = fields.MultipleChoiceField( # choices=((1,'上海'),(2,'北京'),), # initial=[1,], # widget=widgets.SelectMultiple # ) # 单checkbox # user = fields.CharField( # widget=widgets.CheckboxInput() # ) # 多选checkbox,值为列表 # user = fields.MultipleChoiceField( # initial=[2, ], # choices=((1, '上海'), (2, '北京'),), # widget=widgets.CheckboxSelectMultiple # )
4. 动态绑定数据
在使用选择标签时，需要注意choices的选项可以从数据库中获取，但是由于是静态字段 ***获取的值无法实时更新***，那么需要自定义构造方法从而达到此目的。
方式一（推荐）：
from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.validators import RegexValidator
class MyForm(Form):
user = fields.ChoiceField(
widget=widgets.Select
)
def __init__(self, *args, **kwargs):
super(MyForm,self).__init__(*args, **kwargs)
self.fields['user'].widget.choices = models.Classes.objects.all().value_list('id','caption')
方式二：
使用django提供的ModelChoiceField和ModelMultipleChoiceField字段来实现
from django import forms
from django.forms import fields
from django.forms import widgets
from django.forms import models as form_model
from django.core.exceptions import ValidationError
from django.core.validators import RegexValidator
class FInfo(forms.Form):
authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all())
# authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all())
5. 自定义验证方式
简单扩展（利用form组件自带的正则扩展）
方式一：
from django import forms
from django.forms import fields
from django.core.validators import RegexValidator
class MyForm(forms.Form):
user = fields.CharField(
required=True,
error_messages={
'required': '不能为空'
},
validators=[RegexValidator(r'^[1-9]+$', '请输入数字'), RegexValidator(r'^156[1-9]+$', '只能以156开头')]
)
方式二：
from django import forms
from django.forms import fields
class MyForm1(forms.Form):
user = fields.RegexField(
r'^[1-9]+$',
error_messages={
'invalid': '输入错误'
}
)
基于源码流程
from django import forms
from django.forms import fields
from django.core.validators import RegexValidator, ValidationError
from app03.models import *
class MyForm2(forms.Form):
user = fields.CharField()
password = fields.IntegerField()
# 单字段错误验证
# 自定义方法 clean_字段名
# 必须有返回值
# 如果出错：raise ValidationError('。。。')或self.add_error('user', ValidationError('...'))
def clean_user(self):
v = self.cleaned_data['user']
if User.objects.filter(username=v).count():
raise ValidationError('用户名已存在')
return v
def clean_password(self):
return self.cleaned_data['password']
# 整体错误验证
def clean(self):
value_dict = self.cleaned_data
v1 = value_dict.get('user')
v2 = value_dict.get('password')
if v1 == 'root' and v2 == 123:
raise ValidationError('整体错误信息')
else:
return self.cleaned_data
form.is_valid()的执行顺序
- 先按照Form类中定义的顺序，循环校验每一个字段(内置的校验规则)
- 每个字段先校验内置的规则，再校验clean_开头的规则
- 整合for循环结束后，再调用form类中定义的clean()方法
循环form_obj的方式
{{for field in form_obj}}
{{field.label}}
{{field}}
{{field.errors.0}}
{{endfor}}