使用Django提供得forms 表单模块构建得表单结构,能够在数据出现错误,返回页面中仍能够保留以前输入得数据,一样能够限制字段条件;
1. 在app 包路径 建立一个forms_to.py 用于定义类:html
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 并实例化该类:python
<!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>
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类型 ...
# 单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 # )