HTML表单
在HTML中,表单是<form>...</form> 之间元素的集合,它们允许访问者输入文本、选择选项、操作对象和控制等等,然后将信息发送回服务器。
某些表单的元素 —— 文本输入和复选框 —— 非常简单而且内建于HTML 本身。其它的表单会复杂些;例如弹出一个日期选择对话框的界面、允许你移动滚动条的界面、使用JavaScript 和CSS 以及HTML 表单<input> 元素来实现操作控制的界面。与<input> 元素一样,一个表单必须指定两样东西:
- 目的地:响应用户输入数据的URL
- 方式:发送数据所使用的HTTP 方法
例如,Django Admin 站点的登录表单包含几个<input> 元素:type="text" 用于用户名,type="password" 用于密码,type="submit" 用于“Log in" 按钮。它还包含一些用户看不到的隐藏的文本字段,Django 使用它们来决定下一步的行为。
它还告诉浏览器表单数据应该发往<form> 的action 属性指定的URL —— /admin/,而且应该使用method 属性指定的HTTP 方法 —— post。
当触发<input type="submit" value="Log in"> 元素时,数据将发送给/admin/。
Django 中的表单
Django 的Form 类
表单系统的核心部分是Django 的Form 类。Django 的模型描述一个对象的逻辑结构、行为以及展现给我们的方式,与此类似,Form 类描述一个表单并决定它如何工作和展现。
就像模型类的属性映射到数据库的字段一样,表单类的字段会映射到HTML 的<input>表单的元素。
表单字段在浏览器中呈现给用户的是一个HTML 的“widget” —— 用户界面的一个片段。每个字段类型都有一个合适的默认Widget 类,需要时可以覆盖。
widget 部件
实例化、处理和渲染表单
在Django 中渲染一个对象时,我们通常:
- 在视图中获得它(例如,从数据库中获取)
- 将它传递给模板上下文
- 使用模板变量将它扩展为HTML 标记
在模板中渲染表单和渲染其它类型的对象几乎一样,除了几个关键的差别。
构建一个表单
在html里构建这里就不写了
1.在app下面新建一个存放Forn类的文件
例如:myforms.py
#!/usr/bin/env python #-*- coding:utf-8 -*- from django import forms from django.forms import fields class UserForm(forms.Form): user = fields.CharField( max_length=18, min_length=6, required = True, error_messages={ ‘required‘:‘用户输入为空‘, ‘max_length‘:‘用户输入太长了‘, ‘min_length‘:‘用户输入太短了‘ }) #自定义错误显示信息 pwd = fields.CharField(required=True,min_length=8) age = fields.IntegerField(required=True) email = fields.EmailField(required=True,min_length=8, error_messages={ ‘invalid‘:"用户输入格式错误,只要是格式错误都用invalid" })
注:它不包含 <form> 标签和提交按钮。我们必须自己在模板中提供它们。
要操作一个通过URL发布的表单,我们要在视图中实例表单。
2.views.py
from django.shortcuts import render from django.shortcuts import redirect from app01.myfoms import UserForm # Create your views here. def users(request): if request.method == "GET": obj = UserForm() #这就相当于自动生成了一个html return render(request,‘fm.html‘,{‘obj‘:obj}) elif request.method == ‘POST‘: fo = UserForm(request.POST) # print(fo) #前端提交过来的数据 v = fo.is_valid() # 判断发过来的数据验证是否通过 if v: print(fo.cleaned_data) # 查看用户提交的数据 return redirect(‘http://www.baidu.com‘) # 成功验证跳转到百度 else: print(fo.errors) # 查看相应提交数据的错误信息 return render(request, ‘fm.html‘, {"obj": fo}) return render(request, ‘fm.html‘)
3.url
from django.conf.urls import url from django.contrib import admin from app01 import views urlpatterns = [ url(r‘^admin/‘, admin.site.urls), url(r‘^users/$‘, views.users), ]
4.模板html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <form action="/users/" method="POST" novalidate> <p>{{ obj.user }}{{ obj.errors.user.0 }} </p> <p>{{ obj.pwd }}{{ obj.errors.pwd.0 }}</p> <p>{{ obj.age }}{{ obj.errors.age.0 }}</p> <p>{{ obj.email }}{{ obj.errors.email.0 }}</p> <input type="submit" value="提交"> </form> /* obj.error.user.0 是显示在输入框后显示错误的显示信息 */ </body> </html>
提示:
form类实例化的方法和属性 is_valid() 方法 判断表单提交是否合法的数据结构,返回True/False cleaned_data 属性中找到所有合法的表单数据 转换好为Python 的字典类型。
使用表单模板
例如:
1新建一个表单的py文件 例如:myForms.py 在app下面新建表单内容,
内容如下
#!/usr/bin/env python #-*- coding:utf-8 -*- from django import forms from django.forms import fields class UserInfo(forms.Form): user = fields.CharField() age = fields.IntegerField()
2.视图views.py
from django.shortcuts import render from app01 import myForms # Create your views here. def index(request): form = myForms.UserInfo() if request.method == ‘GET‘: return render(request,‘index.html‘,{‘form‘:form})
3.路由urls.py
from django.conf.urls import url from django.contrib import admin from app01 import views urlpatterns = [ url(r‘^admin/‘, admin.site.urls), url(r‘^index/‘, views.index), ]
4.模板html
通过视图把fom表单渲染到模板的html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <form action="/index" method="POST"> <table border="1">{{ form.as_table }}</table> {{ form.as_p }} <ul> {{ form.as_ul }} </ul> </form> </body> </html>
上面用了几个表单渲染,form.as_p 和 forms.as_ul 和 forms.as_table
表单渲染选项
表单模板的额外标签
不要忘记,表单的输出不 包含<form> 标签,和表单的submit 按钮
对于<label>/<input> 对,还有几个输出选项:
- {{ form.as_table }} 以表格的形式将它们渲染在<tr> 标签中
- {{ form.as_p }} 将它们渲染在<p> 标签中
- {{ form.as_ul }} 将它们渲染在<li> 标签中
注意,你必须自己提供<table> 或<ul> 元素。
表单字段详解
在django的form表单api,每个字段都是一个类,所有的字段都继承Field这个类。
提示:多看源码
Field这个类的常用参数
Field required=True, 是否允许为空 widget=None, HTML插件 注:重点 label=None, 用于生成Label标签或显示内容 类似HTML的label的标签 initial=None, 初始值 (<input type="text" value="xixi"> 类似html的input框的value值) help_text=‘‘, 帮助信息(在标签旁边显示) error_messages=None, 错误信息 {‘required‘: ‘不能为空‘, ‘invalid‘: ‘格式错误‘} show_hidden_initial=False, 是否在当前插件后面再加一个隐藏的且具有默认值的插件(可用于检验两次输入是否一直) validators=[], 自定义验证规则 localize=False, 是否支持本地化 disabled=False, 是否可以编辑 label_suffix=None Label内容后缀
常用字段
ChoiceField 选择类型的字段(例如,下拉框,等等) choice[(1,‘北京‘),(2,‘上海‘),(3,‘深圳‘)] 这个选项是提供下拉框的内容 表单模板的额外标签 不要忘记,表单的输出不 包含<form> 标签,和表单的submit 按钮 对于<label>/<input> 对,还有几个输出选项: {{ form.as_table }} 以表格的形式将它们渲染在<tr> 标签中 {{ form.as_p }} 将它们渲染在<p> 标签中 {{ form.as_ul }} 将它们渲染在<li> 标签中 注意,你必须自己提供<table> 或<ul> 元素。 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 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=‘‘, 帮助提示 注:choices选项:由可迭代的二元组组成(比如[(A, B), (A, B) ...]),用来给这个字段提供选择项。如果设置了 choices ,默认表格样式就会显示选择框,而不是标准的文本框,而且这个选择框的选项就是 choices 中的元组。 每个元组中的第一个元素,是存储在数据库中的值;第二个元素是该选项更易理解的描述 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类型 ...
重点form字段
Form重点: - 字段 用于保存正则表达式 ChoiceField ***** MultipleChoiceField CharField IntegerField DecimalField DateField DateTimeField EmailField GenericIPAddressField FileField RegexField
表单字段的HTML插件
所有Field字段本质上封装了两个东西,一个是正则表达式,一个是HTML插件
每个表单字段都有一个对应的Widget 类,它对应一个HTML 表单Widget,例如<input type="text">。
在大部分情况下,字段都具有一个合理的默认Widget。例如,默认情况下,CharField 具有一个TextInput Widget,它在HTML 中生成一个<input type="text">。
Django内置插件
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
常用widget的选择HTML插件
不要将Widget 与表单字段搞混淆。表单字段负责验证输入并直接在模板中使用。Widget 负责渲染网页上HTML 表单的输入元素和提取提交的原始数据。但是,Widget 需要赋值给表单字段。
# 单radio,值为字符串 widgets方式 # user = fields.CharField( # initial=2, # widget=widgets.RadioSelect(choices=((1,‘上海‘),(2,‘北京‘),)) # ) # 单radio,值为字符串 ChoiceField选择字段方式 # 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 # )
提示:根据自已喜好,选择用widget插件,还是ChoiceField方式
widget只能生成form相关的html标签,不能生成div,span标签等等。。。。
数据实时更新
方式一:(推荐)
在使用选择标签时,需要注意choices的选项可以从数据库中获取,但是由于是类属性字段 ***获取的值无法实时更新***,
那么需要自定义构造方法(__init__)从而达到此目的。
from django.forms import Form from django.forms import widgets from django.forms import fields class MyForm(Form): user = fields.ChoiceField( # choices=((1, ‘上海‘), (2, ‘北京‘),), initial=2, widget=widgets.Select ) def __init__(self, *args, **kwargs): super(MyForm,self).__init__(*args, **kwargs) # self.fields[‘user‘].widget.choices = ((1, ‘上海‘), (2, ‘北京‘),) # 或 self.fields[‘user‘].widget.choices = models.Classes.objects.all().value_list(‘id‘,‘caption‘)
方式二:
依赖数据库的model的__str__方法
from django import forms from django.forms import fields from django.forms import widgets from django.forms.models import ModelChoiceField class FInfo(forms.Form): authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all()) # authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all()) to_field_name=‘id‘ #使用id的那列字段作为input框的value值
FORM自定制匹配正则表达式的扩展
方式一
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.CharField( error_messages={‘invalid‘: ‘...‘}, validators=[RegexValidator(r‘^[0-9]+$‘, ‘请输入数字‘), RegexValidator(r‘^159[0-9]+$‘, ‘数字必须以159开头‘)], )
字段下的validator
validators=[RegexValidator(r‘^[0-9]+$‘, ‘请输入数字‘)]
validators 自定义匹配正则表达式,可以有多个匹配的正则表达式,匹配顺序是从前到后
RegexValidator这个类有两个参数,第一个是正则表达式,第二个错误提示
方式二
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.RegexField(r‘^[0-9]+$‘,error_messages={‘invalid‘: ‘...‘})
正则字段
基于源码流程的扩展
如果某一个字段不仅只是自定义正则表达式匹配,例如:还有一些用户注册的唯一性等等要求,这时候就要基于form源码来扩展
单子段验证
重写:clean_字段名方法
from django import forms from django.forms import fields from django.forms import widgets from django.core.exceptions import NON_FIELD_ERRORS, ValidationError class AForm(forms.Form): username = fields.CharField() user_id = fields.IntegerField( widget=widgets.Select(choices=[(0,‘张三‘),(1,‘李四‘),(2,‘老王‘),]) ) # 自定义方法 clean_字段名 # 必须返回值self.cleaned_data[‘username‘] # 如果出错:raise ValidationError(‘用户名已存在‘) def clean_username(self): v = self.cleaned_data[‘username‘] if models.UserInfo.objects.filter(username=v).count(): # 整体错了 # 自己详细错误信息 raise ValidationError(‘用户名已存在‘) return v def clean_user_id(self): return self.cleaned_data[‘user_id‘]
整体错误验证
自定义clean方法
class AForm(forms.Form): username = fields.CharField() user_id = fields.IntegerField( widget=widgets.Select(choices=[(0,‘张三‘),(1,‘李四‘),(2,‘老王‘),]) ) # 自定义方法 clean_字段名 # 必须返回值self.cleaned_data[‘username‘] # 如果出错:raise ValidationError(‘用户名已存在‘) def clean_username(self): v = self.cleaned_data[‘username‘] if models.UserInfo.objects.filter(username=v).count(): # 整体错了 # 自己详细错误信息 raise ValidationError(‘用户名已存在‘) return v def clean_user_id(self): return self.cleaned_data[‘user_id‘] def clean(self): value_dict = self.cleaned_data v1 = value_dict.get(‘username‘) v2 = value_dict.get(‘user_id‘) if v1 == ‘root‘ and v2==1: raise ValidationError(‘整体错误信息‘) return self.cleaned_data