Form表單的功能
- 自動(dòng)生成HTML表單元素
- 檢查表單數(shù)據(jù)的合法性
- 如果驗(yàn)證錯(cuò)誤，重新顯示表單（數(shù)據(jù)不會(huì)重置）
- 數(shù)據(jù)類型轉(zhuǎn)換（字符類型的數(shù)據(jù)轉(zhuǎn)換成相應(yīng)的Python類型）
Form相關(guān)的對(duì)象包括
- Widget：用來渲染成HTML元素的工具，如：forms.Textarea對(duì)應(yīng)HTML中的<textarea>標(biāo)簽
- Field：Form對(duì)象中的一個(gè)字段，如：EmailField表示email字段，如果這個(gè)字段不是有效的email格式，就會(huì)產(chǎn)生錯(cuò)誤。
- Form：一系列Field對(duì)象的集合，負(fù)責(zé)驗(yàn)證和顯示HTML元素
- Form Media：用來渲染表單的CSS和JavaScript資源。
Form Objects
Form對(duì)象封裝了一系列Field和驗(yàn)證規(guī)則，F(xiàn)orm類都必須直接或間接繼承自django.forms.Form，定義Form有兩種方式:
方法一：直接繼承Form
|
1
2
3
4
5
6
|
from django import formsclass ContactForm(forms.Form): subject = forms.CharField(max_length=100,label='主題') message = form.CharField(widget=forms.TextArea) sender = form.EmailField() cc_myself = forms.BooleanField(required=False) |
方法二：結(jié)合Model，繼承django.forms.ModelForm
|
1
2
3
4
5
6
7
8
9
10
|
#models.pyclass Contact(models.Model): title = models.CharField(max_length=30) content = models.CharField(max_length=20)#form.pyclass ConotactForm(ModelForm): class Meta: model = Contact field = ('title','content') #只顯示model中指定的字段 |
在視圖（view）中使用form
在view函數(shù)中使用form的一般情景是：
view.py:
|
1
2
3
4
5
6
7
8
9
10
11
12
|
form django.shortcuts import renderform django.http import HttpResponseRedirectdef contact(request): if request.method=="POST": form = ContactForm(request.POST) if form.is_valid(): #所有驗(yàn)證都通過 #do something處理業(yè)務(wù) return HttpResponseRedirect('/') else: form = ContactForm() return render(request,'contact.html',{'form':form}) |
contact.html:
|
1
2
3
4
5
6
7
8
9
|
<form action='/contact/' method='POST'> {% for field in form %} <div class = 'fieldWrapper'> {{field.label_tag}}:{{field}} {{field.errors}} </div> {% endfor %} <div class='fieldWrapper'> <p><input type='submit' value='留言'></p></div></form> |
處理表單數(shù)據(jù)
form.is_valid()返回true后，表單數(shù)據(jù)都被存儲(chǔ)在form.cleaned_data對(duì)象中（字典類型，意為經(jīng)過清洗的數(shù)據(jù)），而且數(shù)據(jù)會(huì)被自動(dòng)轉(zhuǎn)換為Python對(duì)象，如：在form中定義了DateTimeField，那么該字段將被轉(zhuǎn)換為datetime類型，還有諸如：IntegerField、FloatField
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
if form.is_valid(): subject = form.cleaned_data['subject'] message = form.cleaned_data['message'] sender = form.cleaned_data['sender'] cc_myself = form.cleaned_data['cc_myself'] recipients = ['info@example.com'] if cc_myself: recipients.append(sender) from django.core.mail import send_mail send_mail(subject, message, sender, recipients) return HttpResponseRedirect('/thanks/') # Redirect after POST |
Form的簡單使用方法就這些。 另：
在模版中顯示表單的幾種方式：
顯示form找template中的方法多種多樣，也可以自定義：
|
1
2
3
4
|
<form action="/contact/" method="post">{% csrf_token %}{{ form.as_p }}<input type="submit" value="Submit" /></form> |
還可以使用form.as_table、form.as_ul，分別表示用<p>標(biāo)簽，<table>標(biāo)簽和<ul>表示顯示表單。如果要自定義，你只要獲取到每個(gè)元素的值就行：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
<form action="/contact/" method="post"> {{ form.non_field_errors }} <div class="fieldWrapper"> {{ form.subject.errors }} <label for="id_subject">Email subject:</label> {{ form.subject }} </div> <div class="fieldWrapper"> {{ form.message.errors }} <label for="id_message">Your message:</label> {{ form.message }} </div> <div class="fieldWrapper"> {{ form.sender.errors }} <label for="id_sender">Your email address:</label> {{ form.sender }} </div> <div class="fieldWrapper"> {{ form.cc_myself.errors }} <label for="id_cc_myself">CC yourself?</label> {{ form.cc_myself }} </div> <p><input type="submit" value="Send message" /></p></form> |
每個(gè)form字段都可以使用 {{form.name_of_field}}得到。
也可以通過迭代form，每個(gè)迭代元素對(duì)應(yīng)的是form里面的field
|
1
2
3
4
5
6
7
8
9
|
<form action="/contact/" method="post"> {% for field in form %} <div class="fieldWrapper"> {{ field.errors }} {{ field.label_tag }}: {{ field }} </div> {% endfor %} <p><input type="submit" value="Send message" /></p></form> |
{{field}}有如下屬性：
|
1
2
3
4
|
{{field.lable}}，如：Email address{{field.label_tag}}，如： <label for=id_email>Email address</label>{{field.value}} 如：someone.@gmail.com{{field.errors}} |
實(shí)例：構(gòu)建表單
第一步:首先在models.py中定義一個(gè)表單模型
|
1
2
3
4
5
6
|
class RemarkForm(forms.Form): subject = forms.CharField(max_length=100 ,label='留言標(biāo)題') mail = forms.EmailField(label='電子郵件') topic = forms.ChoiceField(choices=TOPIC_CHOICES,label='選擇評(píng)分') message = forms.CharField(label='留言內(nèi)容',widget=forms.Textarea) cc_myself = forms.BooleanField(required=False ,label='訂閱該貼') |
那個(gè)topic中的choices需要在models.py中定義一個(gè)數(shù)組.
|
1
2
3
4
5
|
TOPIC_CHOICES = ( ('leve1', '差評(píng)'), ('leve2', '中評(píng)'), ('leve3', '好評(píng)'),) |
這樣，之后在html顯示的表單就采用這個(gè)模型的數(shù)據(jù)了。
另外還有一種定義表單模型的方式，那就是直接繼承另一個(gè)models。如果我們?cè)趍odels里設(shè)計(jì)數(shù)據(jù)庫時(shí)，已經(jīng)設(shè)計(jì)好了一個(gè)類(就是數(shù)據(jù)庫的表)之后想復(fù)用這個(gè)類的信息來作為表單的模型，那么很簡單，同樣是在models中的一個(gè)類
|
1
2
3
4
5
6
7
|
class Advertisement(models.Model): #訂單編號(hào) OrderID = models.ForeignKey(OrderInfo) #//廣告標(biāo)題# Title = models.CharField(max_length = 36) #//廣告內(nèi)容# Content = models.CharField(max_length = 600) |
注意，他的類型是models.Model，是做數(shù)據(jù)庫ORM用的。
然后怎么關(guān)聯(lián)呢?
需要導(dǎo)入一個(gè)新的類 (ModelForm)
|
1
2
3
4
5
6
|
from django.forms import ModelFormclass ContactForm(ModelForm): class Meta: model = Advertisement fields = ('Title', 'CustomerID') |
這里的Advertisement就是之前那個(gè)ORM的模型。
第二步：OK，繼續(xù)我們的表單，下一步需要做什么呢？開始在views.py里寫對(duì)表單的調(diào)用吧.
def remark(request):
|
1
2
3
4
5
6
7
8
9
10
|
if request.method == 'POST': # 如果表單被提交 form = ContactForm(request.POST) # 獲取Post表單數(shù)據(jù) if form.is_valid(): # 驗(yàn)證表單 return HttpResponseRedirect('/') # 跳轉(zhuǎn)else: form = ContactForm() #獲得表單對(duì)象 return render_to_response('message.html', { 'form': form,}) |
整個(gè)代碼很簡單，我就不過多的解釋了。
第三步：我們知道django里任何訪問都是通過urls.py來管理的。所以下面我們需要配置一個(gè)路徑。
|
1
|
(r'^message', 'iring.views.remark'), |
第四步：最后應(yīng)該是建立一個(gè)模板的時(shí)候了，因?yàn)槲覀冏罱K是輸出到html上的.注意views的remark函數(shù)最后一行
|
1
2
3
|
return render_to_response('message.html', { 'form': form,}) |
就是講當(dāng)前的表單對(duì)象輸出到message.html里，自動(dòng)生成一個(gè)表單。
所以，先構(gòu)建一個(gè)html.
這個(gè)html模板很簡單，除去不必要的CSS，我只給出核心部分好啦。
|
1
2
3
4
5
6
7
8
9
|
<form action="/message/" method="POST">{% for field in form %} <div class="fieldWrapper"> {{ field.label_tag }}:{{ field }} {{ field.errors }} div>{% endfor %}<div class="fieldWrapper"><p><input type="submit" value="留言" />p>div>form> |
|
1
2
3
|
{% for field in form %}{% endfor %} |
用于對(duì)表單對(duì)象里的元素進(jìn)行遍歷，然后通過
|
1
2
3
|
{{ field.label_tag }}{{ field }} {{ field.errors }} |
這三個(gè)標(biāo)簽來輸出，注意{{ field.errors }}默認(rèn)情況下是不會(huì)輸出的，只有當(dāng)驗(yàn)證表單正確性時(shí)才會(huì)輸出內(nèi)容。
最終我們通過:
http://youdjangourl/message來訪問這個(gè)例子
