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()})
来源:oschina
链接:https://my.oschina.net/u/4265926/blog/3304253