表單介紹

HTML表單負(fù)責(zé)接收用戶的輸入，對輸入進(jìn)行合法格式判斷，并將數(shù)據(jù)發(fā)送到服務(wù)器。一個HTML表單必須指定兩樣?xùn)|西：發(fā)送數(shù)據(jù)的url地址，發(fā)送的HTTP方法（GET、POST）。

GET方法：將用戶數(shù)據(jù)以?<鍵1>=<值1>&<鍵2>=<值2>&...形式拼接到url后面，通常用于請求數(shù)據(jù)、網(wǎng)頁搜索的表單。

POST方法：組合表單的數(shù)據(jù)并進(jìn)行編碼，然后打包發(fā)送到服務(wù)器，數(shù)據(jù)不會出現(xiàn)在url中，通常用于保密信息的發(fā)送、大量數(shù)據(jù)的表單、二進(jìn)制數(shù)據(jù)。

在input標(biāo)簽中

#對于form表單也是一樣，如果前端不指定post方法，默認(rèn)使用get方法。

表單字段（常用）

CharField

渲染類型：TextInput

輸入空值的返回：empty_value設(shè)定的值

轉(zhuǎn)換為對象：Unicode對象

驗(yàn)證：min_length，max_length（如果設(shè)置過）

可用的錯誤信息鍵：min_length，max_length，required

max_length：允許輸入的最大長度

min_length：允許輸入的最小長度

strip：默認(rèn)為True，表示去除前后的空格

empty_value：輸入為空時返回的值，默認(rèn)為空字符串

EmailField

渲染類型：EmailInput

輸入空值的返回：空字符串

轉(zhuǎn)換為對象：Unicode對象

驗(yàn)證：用正則表達(dá)式驗(yàn)證表單的值，必須是合法郵件地址

可用的錯誤信息鍵：required，invalid

max_length：允許輸入的最大長度

min_length：允許輸入的最小長度

表單字段的參數(shù)

error_messages

error_messages={‘key’: ‘value’}

自定義錯誤提示信息，鍵是表單里同名的錯誤類型字符串，值是自定義的提示信息字符串。

其中的key包括：

required，無填寫內(nèi)容

invalid，非法字符

maxlength，超出長度上限

max_length

最大長度

min_length

最小長度

required

required=True/False

該字段必填/非必填。

當(dāng)為True時，<表單對象>.clean(‘‘)和<表單對象>.clean(None)返回ValidationError異常。

當(dāng)為False時，<表單對象>.clean(‘‘)和<表單對象>.clean(None)返回None。

?

label

label=’<顯示值>’

字段渲染成HTML代碼的提示詞，默認(rèn)在后面加冒號。

如字段name = forms.CharField(label=’Your Name’)，顯示為HTML的

<label for=”id_name”>Your name:?</label>

<input id=”id_name”?type="text" name="name" required />

label_suffix

label_suffix=’<字符>’

自定義字符，代替label生成顯示值后面的冒號。

initial

initial=’<值>’

為表單元素定義初始值，即標(biāo)簽中的value=，可傳入值和對象。

#?initial不會作為數(shù)據(jù)提交，表單仍需要用戶填寫數(shù)據(jù)。

只能用initial傳遞初始值，如果在渲染表單的時候傳遞一個初始值字典，會觸發(fā)表單的驗(yàn)證，此時輸出的HTML頁面可能包含驗(yàn)證錯誤。

widget

widget=<widget類>

指定渲染W(wǎng)idget時使用的widget類，即前端中的type類型。

可用attr參數(shù)傳入一個字典，對widget添加CSS樣式，如：

name = forms.CharField(widget=forms.TextInput(attrs={‘class’: ‘special’}) )

comment = forms.CharField(widget=forms.TextInput(attrs={‘size’: ‘40’}) )

help_text

help_text=’<文本>’

設(shè)定輔助性描述文本，相當(dāng)于HTML的默認(rèn)顯示值。

validators

validators=[ ]

傳入列表，包含對字段驗(yàn)證的函數(shù)，自定義驗(yàn)證方法的時候用。

localize

實(shí)現(xiàn)表單數(shù)據(jù)輸入的本地化。

disabled

disabled=True/False

設(shè)置對字段禁用/啟用編輯，禁用編輯后，即使非法篡改前端頁面的屬性向服務(wù)器提交，該字段值也會被忽略。

表單API

綁定數(shù)據(jù)的表單能夠驗(yàn)證數(shù)據(jù)，然后生成HTML表單，未綁定的表單無法驗(yàn)證數(shù)據(jù)，可生成HTML空表單。

創(chuàng)建空表單：f = <表單名>form()#創(chuàng)建表單類的實(shí)例

表單綁定數(shù)據(jù)：data = {:}#字典鍵是表單的字段名，值是傳入的數(shù)據(jù)

? ? ? ? ? ? ? ? ? ? ? ? ? f = <表單名>form(data)

? ? ? ? ? ? ? ? ? ? ? ? ??#傳入空字典將創(chuàng)建一個數(shù)據(jù)為空的已綁定表單

forms.Form實(shí)例的數(shù)據(jù)無法自讀，所以創(chuàng)建表單對象之后不可更改。

表單的綁定

<表單對象>.is_bound

判斷表單是/否綁定了數(shù)據(jù)，返回True/False。

表單的數(shù)據(jù)錯誤驗(yàn)證

<表單對象>.is_valid()

驗(yàn)證表單數(shù)據(jù)合法性，返回True/False。.is_valid()實(shí)際就是檢查<表單對象>.errors是否為空，如果errors列表為空，就把所有數(shù)據(jù)儲存到<表單對象>.cleaned_data字典中。

<表單對象>.errors

包含所有錯誤信息的字典類型，鍵是表單字段名，值是由錯誤信息組成的字符串形列表。

<表單對象>.errors.as_data()

返回錯誤信息的字典形式，將字段映射到原始的ValidationError實(shí)例，如：

{'sender': [ValidationError(['Enter a valid email address.'])?],

'subject': [ValidationError(['This field is required.'])?]?}

<表單對象>.errors.as_json()

錯誤信息字典的JSON序列化形式，如：

{"sender": [{"message": "Enter a valid email address.", "code": "invalid"}],

"subject": [{"message": "This field is required.", "code": "required"}]?}

<表單對象>.add_error(<字段名>, <錯誤信息>)

向表單的指定字段添加錯誤信息。

<表單對象>.has_error(<字段>, code=xxx)

判斷某個字段是/否有指定的xxx錯誤，返回True/False。當(dāng)code=None時，該字段有任何錯誤都返回True。

<表單對象>.non_field_errors()

返回<表單對象>.errors中不是與特定字段關(guān)聯(lián)的錯誤。

?

表單的cleaned_data數(shù)據(jù)

①如果數(shù)據(jù)驗(yàn)證通過，把所有數(shù)據(jù)儲存到<表單對象>.cleaned_data字典中；如果數(shù)據(jù)驗(yàn)證不通過，只把合法的數(shù)據(jù)存到<表單對象>.cleaned_data字典中。

②cleaned_data只包含F(xiàn)orm類中的字段，如果傳遞額外數(shù)據(jù)，將不被儲存。

③傳遞的數(shù)據(jù)不包含F(xiàn)orm類中的某字段，cleaned_data中依然包含該鍵值對，顯示為空值。

表單的數(shù)據(jù)更改驗(yàn)證

<表單對象>.has_changed()

檢查表單數(shù)據(jù)是否從初始值發(fā)生改變，有改變返回True，無改變返回False，如：

data = <字典>

f = ContactForm(request.POST, initial=data) ?????#?POST和data內(nèi)容不一樣

f.has_changed()

<表單對象>.changed_data

返回表單中有數(shù)據(jù)變化的字段的列表，如：

f = ContactForm(request.POST, initial=data) ?????#?POST和data內(nèi)容不一樣

print(“, “.join(f.changed_data) )

表單的HTML生成

form類不包含<form></form>標(biāo)簽和<input type=”submit”>提交按鈕，為方便開發(fā)人員自行編寫控制表單動作和CSS，JS及如bootstrap框架的嵌入。

生成HTML標(biāo)簽的就是表單字段名，每個字段類型都由一個默認(rèn)的HTML標(biāo)簽展示，可用widget參數(shù)指定生成的類型。

表單自動為每個input元素設(shè)置一個，用于的for參數(shù)。

{{ form.as_p }}

將每個字段渲染成標(biāo)簽。

{{ form.as_ul }}

將每個字段渲染成

標(biāo)簽（無序），

{{ form.as_table }}

將表單的每個字段渲染成標(biāo)簽，標(biāo)簽需自己指定。

表單字段在前端的屬性

{{ field.value }} ?? ?? 當(dāng)前字段的值，比如一個Email字段的值：someone@example.com

{{ field.errors }} ? ?? 包含錯誤信息的元素

{{ field.label }} ?? 字段的label信息

{{ field.id_for_label }} 自定義字段標(biāo)簽的id

{{ field.html_name }} 指定字段生成的input標(biāo)簽中name屬性的值

{{ field.help_text }} 字段的幫助信息

{{ field.is_hidden }} 用于判斷當(dāng)前字段是否為隱藏的字段，隱藏則返回True

{{ field.field }} ? ?? 返回字段的參數(shù)列表，例如{{ char_field.field.max_length }}

表單錯誤信息的CSS樣式

class <表單名>FORM(forms.Form):

????error_css_class = ‘error’

????required_css_class = ‘required’

? ??#其它表單字段...

以后這個表單渲染HTML時將自動為error行和required行添加對應(yīng)的CSS樣式。

表單上傳文件

沒看懂，略。。。

模型表單ModelForm

基于model模型創(chuàng)建的表單，對模型的字段進(jìn)行重用，根據(jù)model字段的限制進(jìn)行表單驗(yàn)證。

驗(yàn)證后，ModelForm.save()實(shí)際就是調(diào)用Model.save()，直接保存到數(shù)據(jù)庫。

from django.forms import ModelForm

from <應(yīng)用名>.models import <類>

class <類名>Form(ModelForm): ??????#繼承于ModelForm類

????class Meta: ????????????????????#設(shè)置元類Meta

????????model = <類> ??????????????#設(shè)置model屬性為某個模型類

????????fields = [<字段1>, <字段2>, ...] ?????#用field屬性傳入列表，指定類中的字段

????????fields = ‘__all__’????????????????????#也可用field屬性傳入類的全部字段

????????exclude = [<字段1>, <字段2>, ...] ????#用exclude屬性將排除的字段之外全部傳入

模型表單的保存

<模型表單對象>.save(commit=True) ??????#將form表單的內(nèi)容提交到數(shù)據(jù)庫并保存

如果沒有commit=True就只提交，不保存

指定數(shù)據(jù)對象

form = ModelForm(instance=<綁定的Model對象>)

此時可以直接form.save()將表單數(shù)據(jù)保存到數(shù)據(jù)表中。

#如果不指定某個對象，save()時會在數(shù)據(jù)表中新增一行數(shù)據(jù)

模型字段對應(yīng)表單字段

Model???????????????????????????Form

AutoField ???????????????????????無對應(yīng)

BigAutoField ????????????????????無對應(yīng)

BigIntegerField ??????????????????IntegerField

CharField ???????????????????????相同，如果model設(shè)置null=True，F(xiàn)orm將使用empty_value

CommaSeparatedIntegerField ?????CharField

ForeignKey ??????????????????????ModelChoiceField

ManyToManyField ????????????????ModelMultipleChoiceField

PositiveIntegerField ???????????????IntegerField

PositiveSmallIntegerField ??????????IntegerField

SmallIntegerField ?????????????????IntegerField

TextField ?????????????????????????CharField，屬性widget=forms.Textarea

模型字段設(shè)置blank=True屬性，表單字段將設(shè)置required=False，反之相反。

模型字段的verbose_name屬性會設(shè)為表單字段的label屬性，并將第一個字母大寫。

模型字段設(shè)置editable=False屬性，表單類中將不會出現(xiàn)該字段，因?yàn)樵撟侄尾豢删庉嫛?/p>

模型字段的help_text屬性即為表單字段的help_text屬性。

模型字段設(shè)置choices參數(shù)，表單字段的widget屬性將設(shè)置為Select，其選項(xiàng)和模型字段相同。表單選項(xiàng)中通常會包含一個空選項(xiàng)作為默認(rèn)，如果該字段必選，會強(qiáng)制用戶選擇一個選項(xiàng)；如果模型字段具有default參數(shù)，就不會在表單選項(xiàng)中添加空選項(xiàng)。

模型表單的驗(yàn)證

用.is_valid()方法或查詢.errors列表，也可以重寫模型表單的def clean()方法進(jìn)行額外的驗(yàn)證，如：

class <類名>Form(ModelForm):

????class meta:

? ??????#?...

def clean_<函數(shù)名>(self):

? ??#驗(yàn)證self.cleaned_data字典的數(shù)據(jù)...

????return <數(shù)據(jù)>

自定義ModelForm字段

使用元類Meta的widgets屬性：

class <類名>Form(ModelForm):

????class Meta:

????????model = <類>

????????fields = [‘<字段1>’, ...]

????????widgets = { ???????????????????????#傳入字典，鍵是模型字段名，值是自定義的內(nèi)容

????????????‘<字段1>’:Textarea(attrs={‘cols’:80, ‘rows’:20} ),

????????????...

????????}

ModelForm字段的本地化

使用Meta類的localized_fields屬性，傳入一個元組，指定本地化的字段：

class <類名>Form(ModelForm):

class meta:

????model = <類>

????localized_fields = (‘<字段1>’, ...) ??????#傳入’__all__’表示將類中的所有字段本地化

表單示例

①在forms.py中：

from django import forms

class <表單名>Form(forms.Form): ????#所有表單繼承于forms.Form類

????sender = forms.EmailField()

????name = forms.CharField(label=’Your Name’, max_length=100)

? ??#一個字段代表中的一個元素，字段負(fù)責(zé)驗(yàn)證和轉(zhuǎn)換數(shù)據(jù)

? ??#?label用于設(shè)置說明標(biāo)簽，這里的max_length同時限制前端和后端的輸入長度

②在views.py中：

from .forms import <表單名>Form

def get_name(request):

????if request.method == ’POST’: ?????????#對于POST方法發(fā)送數(shù)據(jù)，接收數(shù)據(jù)并驗(yàn)證、處理

????a_form = <表單名>Form(request.POST)

? ??#用request.POST字典構(gòu)造forms.Form類實(shí)例，將所有數(shù)據(jù)加載到表單中

????????if a_form.is_valid():

? ??????????#處理表單數(shù)據(jù)...

????????????return HttpResponseRedirect(‘/xxx/’) ???#處理成功，重定向到一個新url

????if request.method == ’GET’: ????????????????#對于GET方法請求數(shù)據(jù)，返回空表單到模板

????????a_form = <表單名>Form()

????return render(request, ‘xxx.html’, {‘form’: a_form}

#處理不成功時，給用戶返回這個模板。如果數(shù)據(jù)不合法，邏輯會在if a_form.is_valid()處斷開，

此時的a_form是包含原數(shù)據(jù)的表單，方便用戶修改

③在templates中：

<form action="/xxx/" method="post">??????????#寫標(biāo)簽

????{% csrf_token %}

????{{ form }}?????????????????????????????????#表單模型生成的form表單元素

????<input type="submit" value="Submit" />??????#寫提交按鈕

</form>

{{ form.<字段名> }} ?????????????獲取表單的字段內(nèi)容，用于手動渲染表單

{{ form.<字段名>.label_tag }} ?????生成<label>標(biāo)簽，用于手動渲染表單

{{ form.hidden_fields }} ??????????表單中的不可見字段的集合

{{ form.visible_fields }} ???????????表單中的可見字段的集合

表單模板的重用

將表單模板保存為一個獨(dú)立HTML文件，然后用{% include %}引用：

{% include ‘xxxform.html’?%}

{% for field in form %}

? ??#處理字段...

{% endfor %}

用with參數(shù)給表單取別名，防止名稱沖突：

{% include ‘xxxform.html’?with form=<別名> %}

{% for field in <別名> %}

? ??#處理字段...

{% endfor %}