在Django的視圖中使用form對象的方法

2020-01-04 18:02:34

字體：大中小

來源：轉載

供稿：網友

這篇文章主要介紹了在Django的視圖中使用form對象的方法,Django是Python豐富多彩的開發框架中最具有人氣的一個,需要的朋友可以參考下

在學習了關于Form類的基本知識后，你會看到我們如何把它用到視圖中，取代contact()代碼中不整齊的部分。一下示例說明了我們如何用forms框架重寫contact()：

# views.py

from django.shortcuts import render_to_response

from mysite.contact.forms import ContactForm

def contact(request):

if request.method == 'POST':

form = ContactForm(request.POST)

if form.is_valid():

cd = form.cleaned_data

send_mail(

cd['subject'],

cd['message'],

cd.get('email', 'noreply@example.com'),

['siteowner@example.com'],

)

return HttpResponseRedirect('/contact/thanks/')

else:

form = ContactForm()

return render_to_response('contact_form.html', {'form': form})

# contact_form.html

<html>

<head>

<title>Contact us</title>

</head>

<body>

<h1>Contact us</h1>

{% if form.errors %}

<p style="color: red;">

Please correct the error{{ form.errors|pluralize }} below.

</p>

{% endif %}

<form action="" method="post">

<table>

{{ form.as_table }}

</table>

<input type="submit" value="Submit">

</form>

</body>

</html>

看看，我們能移除這么多不整齊的代碼! Django的forms框架處理HTML顯示、數據校驗、數據清理和表單錯誤重現。

嘗試在本地運行。裝載表單，先留空所有字段提交空表單;繼而填寫一個錯誤的郵箱地址再嘗試提交表單;最后再用正確數據提交表單。 (根據服務器的設置，當send_mail()被調用時，你將得到一個錯誤提示。而這是另一個問題。)

改變字段顯示

你可能首先注意到：當你在本地顯示這個表單的時，message字段被顯示成`` input type=”text”`` ，而它應該被顯示成<`` textarea`` >。我們可以通過設置* widget* 來修改它：

from django import forms

class ContactForm(forms.Form):

subject = forms.CharField()

email = forms.EmailField(required=False)

message = forms.CharField(**widget=forms.Textarea** )

forms框架把每一個字段的顯示邏輯分離到一組部件(widget)中。每一個字段類型都擁有一個默認的部件，我們也可以容易地替換掉默認的部件，或者提供一個自定義的部件。

考慮一下Field類表現* 校驗邏輯* ，而部件表現* 顯示邏輯* 。

設置最大長度

一個最經常使用的校驗要求是檢查字段長度。另外，我們應該改進ContactForm，使subject限制在100個字符以內。為此，僅需為CharField提供max_length參數，像這樣：

from django import forms

class ContactForm(forms.Form):

subject = forms.CharField(**max_length=100** )

email = forms.EmailField(required=False)

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

選項min_length參數同樣可用。

設置初始值

讓我們再改進一下這個表單：為字subject段添加* 初始值* ： "I love your site!" (一點建議，但沒壞處。)為此，我們可以在創建Form實體時，使用initial參數：

def contact(request):

if request.method == 'POST':

form = ContactForm(request.POST)

if form.is_valid():

cd = form.cleaned_data

send_mail(

cd['subject'],

cd['message'],

cd.get('email', `'noreply@example.com`_'),

[`'siteowner@example.com`_'],

)

return HttpResponseRedirect('/contact/thanks/')

else:

form = ContactForm(

**initial={'subject': 'I love your site!'}**

)

return render_to_response('contact_form.html', {'form': form})

現在，subject字段將被那個句子填充。

請注意，傳入* 初始值* 數據和傳入數據以* 綁定* 表單是有區別的。最大的區別是，如果僅傳入* 初始值* 數據，表單是unbound的，那意味著它沒有錯誤消息。

自定義校驗規則

假設我們已經發布了反饋頁面了，email已經開始源源不斷地涌入了。這里有一個問題：一些提交的消息只有一兩個字，我們無法得知詳細的信息。所以我們決定增加一條新的校驗：來點專業精神，最起碼寫四個字，拜托。

我們有很多的方法把我們的自定義校驗掛在Django的form上。如果我們的規則會被一次又一次的使用，我們可以創建一個自定義的字段類型。大多數的自定義校驗都是一次性的，可以直接綁定到form類.

我們希望`` message`` 字段有一個額外的校驗，我們增加一個`` clean_message()`` 方法到`` Form`` 類：

from django import forms

class ContactForm(forms.Form):

subject = forms.CharField(max_length=100)

email = forms.EmailField(required=False)

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

def clean_message(self):

message = self.cleaned_data['message']

num_words = len(message.split())

if num_words < 4:

raise forms.ValidationError("Not enough words!")

return message

Django的form系統自動尋找匹配的函數方法，該方法名稱以clean_開頭，并以字段名稱結束。如果有這樣的方法，它將在校驗時被調用。

特別地，clean_message()方法將在指定字段的默認校驗邏輯執行* 之后* 被調用。(本例中，在必填CharField這個校驗邏輯之后。)因為字段數據已經被部分處理，所以它被從self.cleaned_data中提取出來了。同樣，我們不必擔心數據是否為空，因為它已經被校驗過了。

我們簡單地使用了len()和split()的組合來計算單詞的數量。如果用戶輸入字數不足，我們拋出一個forms.ValidationError型異常。這個異常的描述會被作為錯誤列表中的一項顯示給用戶。

在函數的末尾顯式地返回字段的值非常重要。我們可以在我們自定義的校驗方法中修改它的值(或者把它轉換成另一種Python類型)。如果我們忘記了這一步，None值就會返回，原始的數據就丟失掉了。

指定標簽

HTML表單中自動生成的標簽默認是按照規則生成的：用空格代替下劃線，首字母大寫。如email的標簽是"Email" 。(好像在哪聽到過? 是的，同樣的邏輯被用于模塊(model)中字段的verbose_name值。我們在第五章談到過。)

像在模塊中做過的那樣，我們同樣可以自定義字段的標簽。僅需使用label，像這樣：

class ContactForm(forms.Form):

subject = forms.CharField(max_length=100)

email = forms.EmailField(required=False, **label='Your e-mail address'** )

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