python3之Django表单(一)
1、HTML中的表单
在HTML种，表单是在<form>…</form>种的元素，它允许用户输入文本，选择选项，操作对象等，然后发送这些数据到服务器
表单元素允许用户在表单种输入内容如，文本域(textarea)、下拉列表、单选框(radio-buttons)、复选框(checkboxes)等。
大多数情况下被用到的表单标签是输入标签(<input>)，输入类型是由类型属性(type)定义的，大多数经常被用到的输入类型下面做简单介绍：
（1）文本域（Text Fields）
文本域通过<input type=”text”>标签来设定，当用户要在表单种输入字母，数字等内容是，就会用到文本域，在大多数浏览器种，文本域的缺省宽度是20个字符：
<form> 姓名:<input type="text" name="username"><br> </form>
（2）密码字段
密码字段通过标签<input type=”password”>来定义，密码字段字符不会明文显示，而是以星号或圆点替代：
<form> 姓名:<input type="text" name="username"><br> 密码:<input type="password" name="password"> </form>
（3）单选按钮（Radio Buttons）
<input type=”radio”>标签定义了表单单选框选项
<form> 姓名:<input type="text" name="username"><br> 密码:<input type="password" name="password"><br> 性别:<input type="radio" name="sex" value="man">男<input type="radio" name="sex" value="weman">女<br> </form>
（4）复选框（Checkboxes）
<input type=”checkbox”定义了复选框，用户可以从若干个给定的选择种选择多个
<form> 姓名:<input type="text" name="username"><br> 密码:<input type="password" name="password"><br> 性别:<input type="radio" name="sex" value="man">男<input type="radio" name="sex" value="weman">女<br> 爱好:<input type="checkbox" name="vehicle" value="yundong">运动 <input type="checkbox" name="vehicle" value="youxi">游戏 <input type="checkbox" name="vehicle" value="xuexi">学习 </form>
（5）提交按钮（Submit Button）
<input type=”submit”>定义了提交按钮，当用户单击确认按钮时，表单的内容就会被传送到动作属性定义的目的文件中
<form action="index.html" method="post"> 姓名:<input type="text" name="username"><br> 密码:<input type="password" name="password"><br> 性别:<input type="radio" name="sex" value="man">男<input type="radio" name="sex" value="weman">女<br> 爱好:<input type="checkbox" name="vehicle" value="yundong">运动 <input type="checkbox" name="vehicle" value="youxi">游戏 <input type="checkbox" name="vehicle" value="xuexi">学习<br> <input type="submit" value="提交"> </form>
浏览器表单中的数据会发往action属性指定的URL，并且使用它的method属性指定的HTTP方法post，当点击submit类型的提交时，会将数据发送到index.html中。
HTML5有许多新的input类型：
color类型选取颜色，date类型日期选择器，datetime-local类型选择一个日期和时间，email类型用于e-mail地址的输入域，month类型允许选择一个月份，number类型用于数值的输入域，rang类型定义一定范围内数字的输入域，显示为滑动条可设置最大值max和最小值min，search类型用于搜索域，tel类型定义电话号码字段，time类型定义一个时间选择，url类型用于URL地址的输入域，week类型允许选择周和年。
处理表单时只会用到GET和POST两种HTTP方法，GET方法会将提交的数据捆绑到URL中，而POST通过加密的方式在后台提交
2、Django中的表单
Django会处理涉及表单的三个部分：
准备并重组数据，以便下一步的渲染；为数据创建HTML表单；接收并处理客户端提交的表单以及数据。
Django表单系统的核心组件是Form类，Form类描述一张表单并决定它如何工作并呈现
Form类，类似于模型类的字段映射到数据库字段的方式，表单类的字段会映射到HTML表单的<input>元素，表单字段本身也是类，它们管理表单数据并提交表单执行验证，在浏览器中表单字段以HTML控件的形式展现给我们，在Django中每个字段类型都有与之匹配的控件类，在必要时也可以覆盖
在Django中渲染一个对象的过程通常为：在视图中获取数据，然后将数据传递给模板，使用模板变量将数据扩展到HTML标记，下面我们在Django中构建表单
在app中新建forms.py文件：
from django import forms #首先它继承Form类，然后通过控件类CharField定义文本域并指定属性 class IndexForm(forms.Form): username = forms.CharField(label=\'姓名\',max_length=100)
然后在编辑视图并引入表单类：
#views.py from django.shortcuts import render from django.http import HttpResponse from .forms import IndexForm #新建视图函数处理表单，首先判断提交类型为post则通过表单类接收POST请求数据并填充表单类，然后判断数据是否有效并提交到后台，此处做演示只做判断并提示接收成功，
#如果提交类型不为POST则创建空表单通过变量传递给模板 def get_name(request): if request.method == \'POST\': form = IndexForm(request.POST) print(form) if form.is_valid(): return HttpResponse(\'提交到后台成功！\') else: form = IndexForm() return render(request,\'index.html\',{\'form\':form})
表单类生成的数据如下：
<tr><th><label for="id_username">姓名:</label></th><td><input type="text" name="username" value="root" maxlength="100" required id="id_username"></td></tr>
在模板中只需简单的配置form标签并接收变量，注意表单不包含提交标签需要在模板中自己创建
<form action="{% url \'formtest\' %}" method="post"> {% csrf_token %} #此处为跨站请求伪造保护功能django自提供 {{ form }} <input type="submit" value="提交"> </form>
页面程序效果：
<form action="/" method="post"> <input type="hidden" name="csrfmiddlewaretoken" value="e9Je91NyzZFWx83yXQbSiHYYjH3g4tsiz22zAjEAhSfKnNzPjAINCVd1iHZAnC4B"> <label for="id_username">姓名:</label><input type="text" name="username" maxlength="100" required="" id="id_username"> <input type="submit" value="提交"> </form>
在模板中我们只需将表单在上下问中进行渲染，来得到对应的标签元素，如上面的form变量渲染{{ form }}
但在表单渲染选项还可以使用其他渲染方式：
{{ form.as_table }}包装在<tr>标记中的表格单元格显示数据，但必须自己提供外层<table>元素
{{ form.as_p }}包裹在<p>标记中的显示数据
{{ form.as_ul }}包裹在<li>标记中显示数据，但必须自己提供外层<ul>元素
手动渲染字段：
循环遍历每个字段对字段属性手动渲染，如下field.errors输出包含改字段验证的错误信息，field.label_tag为带<label>标签的label值
#遍历表单字段 <form action="{% url \'index\' %}" method="post"> {% csrf_token %} {% for field in form %} {{ field.errors }} {{ field.label_tag }} {{ field }}<br> {% endfor %} <input type="submit" value="提交"> </form> #渲染效果 <form action="/" method="post"> <input type="hidden" name="csrfmiddlewaretoken" value="benu1PCIYH6XKtSxa7cQyR8wwwIYvae7w7GPs7tKGAGLA8oOwRJLS5nzvwEiOjQq"> <label for="id_subject">Subject:</label> <input type="text" name="subject" maxlength="100" required="" id="id_subject"><br> <label for="id_message">Message:</label> <textarea name="message" cols="40" rows="10" required="" id="id_message"></textarea><br> <label for="id_sender">Sender:</label> <input type="email" name="sender" required="" id="id_sender"><br> <label for="id_cc_myself">Cc myself:</label> <input type="checkbox" name="cc_myself" id="id_cc_myself"><br> <input type="submit" value="提交"> </form>
field.label_tag：输出field的label元素，如：<label for=”id_subject”>Subject:</label>
field：输出field的input，如：<input type=”text” name=”subject” maxlength=”100″ required=”” id=”id_subject”>
field.errors：输出field的errors元素，一般在form表单验证出错时显示
field.id_for_label：输出字段的ID值
field.value：输出字段填充的值
field.html_name：输出字段的名称
field.help_text：输出与该字段的帮助文本
field.is_hidden：如果是隐藏字段属性值为True否则为False
3、表单集
Formset表单集是多个表单的集合，Formset在web开发中应用很普遍，它可以让用户在同一个页面提交多张表单，一键添加多个数据
Django针对不同的formset提供了三种方法：formet_factory，modelformset_factory和inlineformset_factory
（1）使用formset_factory
对应继承forms.Form的自定义表单，我们可以使用formset_factory，通过设置extra指定表单数量，max_num指定表单数量最大值
首先创建表单并使用formset_factory方法指定创建表单集并指定表单数量
#forms.py from django import forms from django.forms import formset_factory class registerForm(forms.Form): username = forms.CharField(max_length=120) age = forms.IntegerField() pub_date = forms.DateField(required=False) registerFormset = formset_factory(registerForm,extra=3,max_num=5)
在视图views.py里使用formset
#views.py from django.shortcuts import render,HttpResponse from .forms import registerFormset def register(request): if request.method == \'POST\': formset = registerFormset(request.POST,request.FILES) if formset.is_valid(): return HttpResponse(\'formset is ok\') else: formset = registerFormset() return render(request,\'register.html\',context={\'formset\':formset})
最后在模版中应用表单即可
<form action="{% url \'register\' %}" method="post"> {{ formset.management_form }} {% for form in formset %} {{ form.as_p }} {% endfor %} </form>
4、从模型创建表单
首先创建model模型：
from django.db import models from django.utils import timezone TITLE_CHOICES = ( (\'MR\',\'Mr.\'), (\'MRS\',\'Mrs.\'), (\'MS\',\'Ms.\'), ) class Author(models.Model): name = models.CharField(max_length=100,verbose_name=\'姓名\') title = models.CharField(max_length=3,choices=TITLE_CHOICES,verbose_name=\'标题\') birth_date = models.DateField(default=timezone.now,blank=True,null=True,verbose_name="创建时间") def __str__(self): return self.name
根据模型创建表单文件：
#forms.py #导入模型表单类 from django.forms import ModelForm from .models import Author #继承模型表单类创建表单 class AuthorForm(ModelForm): class Meta: model = Author #指定model fields = [\'name\',\'title\',\'birth_date\'] #指定要显示的字段，全显示可使用"__all__"
在通过模型创建表单时，我们只需继承Django的模型表单类，然后重写它的属性即可，model指定要创建表单的模型，fields指定显示的模型字段,全显示可以用“__all__”代替，还有其他的类属性exclude指定排除的字段，labels指定提示信息，help_texts指定帮助提示信息，widgets指定自定义插件，error_messages自定义错误信息，field_classes自定义字段类，localized_fields本地化时区时间，根据setting中TIME_ZONE设置的不同时区显示时间
from django import forms from django.forms import ModelForm from .models import Author class AuthorForm(ModelForm): class Meta: model = Author fields = [\'name\',\'title\',\'birth_date\'] widgets = { \'title\':forms.Textarea(attrs={\'cols\':80,\'rows\':20}) } #覆盖重写title字段的类型 labels = { \'name\':\'作者\', \'title\':\'头衔\', \'birth_date\':\'出生日期\', } error_messages = { \'name\':{ \'max_length\':\'名字长度在15个字符内\', } }
在django中的模型字段和表单字段的字段类型定义都差不多，比较特殊的是ForeignKey和ManyToManyField模型字段在表单中的字段类型会有所不同：
ForeignKey由django.forms.ModelChoiceField表示，它是一个ChoiceField，其选项是一个模型QuerySet
ManyToManyField由django.forms.ModelMultipleChoiceField表示，它是一个MultipleChoiceField，其选项为一个模型QuerySet
另外，每个生成的表单字段的属性设置如下：
如果模型字段设置了blank=True，那么表单字段的required属性被设置为False,否知为True
表单字段的label设置为模型字段的verbose_name，并且首字母大写
表单字段的help_text设置为模型字段的help_text
如果模型字段设置了choices，那么表单字段的widget会被设置为select，其选项来自模型字段的choices，这些选项通常包含一个默认选中的空选项，如果字段设置了必填，则会强制用户进行选项，如果模型字段设置了blank=False以及一个明确的default值，则表单字段中不会包含空选项
在视图中使用表单：
#views.py from django.shortcuts import render,HttpResponse from .forms import AuthorForm from .models import Author def test(request): if request.method == \'POST\': author_form = AuthorForm(request.POST) if author_form.is_valid(): author_form.save(commit=True) return HttpResponse(\'提交成功\') else: author_form = AuthorForm() obj = Author.objects.all() return render(request,\'test.html\',{"author_form":author_form,\'obj\':obj})
views.py中使用ModelForm的save()方法将表单数据保存到数据库中，参数commit为True时写如数据库，如果为False则创建一个Model对象但不保存到数据库中，如果要更新某个对象可以使用save的instance参数来指定要更新的model对象
在模板中提交并展示数据：
#test.html <body> <h2>Author Form:</h2> <form action="{% url \'test\' %}" method="post"> {% csrf_token %} {{ author_form }} <input type="submit" value="提交"> </form> <h2>Author Form output:</h2> <ul> {% for i in obj %} <li>{{ i.id }}:{{ i.name }}:{{ i.title }}:{{ i.birth_date }}</li> {% endfor %} </ul> </body>
表单模板ModelForm中有一个工厂函数可以直接通过Model创建表单modelform_factory()，在不需要很多自定义的情况下是很方便的
from .models import Author from django import forms from django.forms.models import modelformset_factory modelform_Author = modelformset_factory(model=Author,fields=(\'__all__\'),widgets={\'title\':forms.Textarea()})