forms模块

Django中的forms模块

在Django中提供了 forms 模块,用forms 模块可以自动生成form内部的表单控件,同时在服务器端可以用对象的形式接收并操作客户端表单元素，并能对表单的数据进行服务器端验证

一forms模块的作用

　　通过 forms 模块,允许将表单与class相结合，允许通过 class 生成表单

二使用 forms 模块的步骤

1.在应用中创建 forms.py

2.导入 django 提供的 forms

　　from django import forms

3.创建class,一个class会生成一个表单

#定义表单类
class ClassName(forms.Form):
        ...

4.在 class 中创建类属性

　　一个类属性对应到表单中是一个控件

5.利用Form 类型的对象自动成表单内容

6.读取form表单并进行验证数据

三form.Form的语法

　　属性 = forms.Field类型(参数)

1.类型

class XXX(froms.Form):
    forms.CharField() : 文本框 <input type="text">
    forms.ChoiceField() : 下拉选项框 <select>
    forms.DateField() : 日期框 <input type="date">
    ... ...

2.参数

label:控件前的文本
widget:指定小部件
initial:控件的初始值(主要针对文本框类型)
required:是否为必填项，值为(True/False)

form表单示例

手动实现Form表单

<form action="/test_form1" method="post">
    <div>
        <label for="id_input_text">请输入内容:</label> <input type="text" name="input_text" id="id_input_text" />
    </div>
    <button type="submit">提交</button>
</form>

Django Form 实现 Form 表单

class MySearch(forms.Form):
    input_text = forms.CharField(label = '请输入内容')

四在模板中解析form对象

1.方法

　　需要自定义

　　表单中的按钮需要自定义

2.解析from对象

在 视图中创建form对象并发送到模板中解析.
ex:
    form = XXXForm()
    return render(request,'xx.html',locals())

　　(1)手动解析 {% for field in form %}

　　　　　　field : 表示的是form对象中的每个属性(控件)

　　　　　　{{field.label}} : 表示的是label参数值

　　　　　　{{field}} : 表示的就是控件

　　　　　　{% endfor %}

　　(2)自动解析

　　　　{{form.as_p}}　将form中的每个属性(控件/文本)都使用p标记包裹起来再显示

　　　　{{form.as_ul}}　将form中的每个属性(控件/文本)都使用li标记包裹起来再显示

　　　　　　注意:必须手动提供ol 或 ul 标记

　　　　{{form.as_table}}　将 form 中的每个属性(控件/文本)都使用tr标记包裹起来再显示

　　　　　　注意:必须手动提供table标记

五通过 forms 对象获取表单数据

1.通过 forms.Form 子类的构造器来接收 post 数据

　　form = XXXForm(request.POST)

2.必须是 form 通过验证后,才能取值

　　form.is_valid()

　　　　返回True:通过验证,可以取值

　　　　返回False:暂未通过验证,则不能取值

3.通过 form.cleaned_data 字典的属性接收数据

　　form.cleaned_data : dict 类型

六Field 内置小部件 - widget

1.什么是小部件

　　表示的是生成到网页上的控件以及一些其他的html属性

message=forms.CharField(widget=forms.Textarea)
upwd=forms.CharField(widget=forms.PasswordInput)

2.常用的小部件类型

widget名称	对应和type类值
TextInput	type='text'
PasswordInput	type='password'
NumberInput	type="number"
EmailInput	type="email"
URLInput	type="url"
HiddenInput	type="hidden"
CheckboxInput	type="checkbox"
CheckboxSelectMultiple	type="checkbox"
RadioSelect	type="radio"
Textarea	textarea标记
Select	select标记
SelectMultiple	select multiple 标记

3.小部件的使用

(1)继承子forms.Form

语法

属性 = forms.CharField() #无预选值使用
    text,password,email,url,textarea,checkbox
属性 = forms.ChoiceField() #有预选值使用
    checkbox,radio,select

属性 = forms.CharField(
    label='xxx',
    widget=forms.小部件类型
)

示例

upwd = forms.CharField(
    label='用户密码',
    widget=forms.PasswordInput
)

message = forms.CharField(
    label='评论内容',
    widget=forms.Textarea
)

文档参见https://docs.djangoproject.com/en/1.11/topics/forms/

七form表单验证

django form 提供表单和字段验证

当在创建有不同的多个表单需要提交的网站时，用表单验证比较方便验证的封装

当调用form.is_valid() 返回True表示当前表单合法，当返回False说明表单验证出现问题

验证步骤:

　　1.先对form.XXXField() 参数值进行验证，比如:min_length,max_length, validators=[...],如果不符合form.is_valid()返回False

　　2.对各自from.clean_zzz属性名(self): 方法对相应属性进行验证,如果验证失败form.is_valid()返回False

　　3.调胳form.clean(self): 对表单的整体结构进行验证，如果验证失败form.is_valid()返回False

　　4.以上验证都成功 form.is_valid()返回True

验证方法:

validators = [验证函数1, 验证函数1]

　　验证函数验证失败抛出forms.ValidationError

　　验证成功返回None

def clean_xxx属性(self):

　　验证失败必须抛出forms.ValidationError

　　验证成功必须返回xxx属性的值

def clean(self):