Django-form表单
在Django中使用forms 构建表单
使用Django提供得forms 表单模块构建得表单结构，可以在数据出现错误，返回页面中仍可以保留之前输入得数据，同样可以限制字段条件；
在Django中通过forms构建一个表单
1. 在app 包路径 创建一个forms_to.py 用于定义类：
from django import forms
from django.forms import widgets
# 通过定义一个 类 来设置所有的标签类型
# IntegerField 只允许为数字
# CharField 为字符串
# EmailField 格式需要为 Email
class RegForm(forms.Form):
# 长度最多 12 字符，最少 6 字符;
# 当超出该字符时，浏览器会阻止多余字符得输入；
# 当少于这些字符时，会返回 min_length 得提示 （可自定义）
username = forms.CharField(
max_length=12,
min_length=6,
error_messages={"required": "该字段不能为空",
"min_length":"最少为6字符",
"max_length":"最多为12个字符"})
password = forms.IntegerField(
# widgets.PasswordInput() 用于渲染密码 加密
widget=widgets.PasswordInput(),
error_messages={"invalid": "格式错误，必须为数字"}
)
repeat_password = forms.CharField(
# 可以添加 标签属性
widget=widgets.PasswordInput(attrs={"class": "pwd"})
error_messages={"required": "该字段不能为空",}
)
email = forms.EmailField()
umout = forms.CharField(
# 用户 渲染 select 标签下拉框
widget=widgets.Select(choices=((1, "上海"), (2, "北京")))
)
2. 在views.py中引入forms_to.py 并实例化该类：
from django.shortcuts import render,redirect,HttpResponse
# 导入自定义的 forms_to form表单类
from app01 import forms_to
def reg(request):
# 如果请求方式为 POST 获取前端传入的 值
if request.method == "POST":
# 将传入的值，放入到 RegForm 进行实例化
regForm = forms_to.RegForm(request.POST)
# 传入值的实例化数据，有一个is_valid 属性；当所有的验证都通过的时候返回 True
if regForm.is_valid():
# 全部正确 数据 依照字典的形式 都存放在 regForm.cleaned_data 里面
print("全对：", regForm.cleaned_data)
# {'email': 'asdfsdf@qq.com', 'umout': '1', 'password': 'asdfasdf', 'username': 'asdfas', 'repeat_password': 'safdsaf'}
username = regForm.cleaned_data.get("username")
password = regForm.cleaned_data.get("password")
# 将获取的数据存入数据库即可
else:
# 只要有错误，就会走 else
# 并在 regForm.errors 存放 错误得部分
# 在regForm.cleaned_data 存放 正确得部分
# print(regForm.errors.get("username")[0])
# 存放 错误的信息
print(regForm.cleaned_data)
return render(request, "reg.html", {"regForm": regForm})
# 实例化 RegForm 类 并将 实例化的结果传给 前端渲染
regForm=forms_to.RegForm()
return render(request, "reg.html", {"regForm": regForm})
3. 在views.py中引入forms_to.py 并实例化该类：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
<style>
.error{
color: red;
}
</style>
</head>
<body>
<form action="/reg/" method="post">
{% csrf_token %}
{# 模板中使用regForm 获取实例化得方法 #} {# regForm.errors.username.0 获取传入错误得第一个错误 #}
<p>姓名{{ regForm.username }}<span class="error">{{ regForm.errors.username.0 }}</span></p>
<p>密码{{ regForm.password }}<span class="error">{{ regForm.errors.password.0 }}</span></p>
<p>确认密码{{ regForm.repeat_password }}<span class="error">{{ regForm.errors.repeat_password.0 }}</span></p>
<p>邮箱{{ regForm.email }}<span class="error">{{ regForm.errors.email.0 }}</span></p>
<p>城市{{ regForm.umout }}</p>
<p><input type="submit" value="提交"></p>
</form>
</body>
</html>
form 组建常用字段
一、Django内置字段
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类型
...
二、Django常用选择插件
# 单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
# )