詳解Django中的form庫的使用

2020-01-04 18:02:34

字體：大中小

來源：轉載

供稿：網友

這篇文章主要介紹了詳解Django中的form庫的使用,Django是最為著名的Python編程框架,需要的朋友可以參考下

Django帶有一個form庫，稱為django.forms，這個庫可以處理我們本章所提到的包括HTML表單顯示以及驗證。接下來我們來深入了解一下form庫，并使用她來重寫contact表單應用。

Django的newforms庫

在Django社區上會經?？吹絛jango.newforms這個詞語。當人們討論django.newforms，其實就是我們本章里面介紹的django.forms。

改名其實有歷史原因的。當Django一次向公眾發行時，它有一個復雜難懂的表單系統：django.forms。后來它被完全重寫了，新的版本改叫作：django.newforms，這樣人們還可以通過名稱，使用舊版本。當Django 1.0發布時，舊版本django.forms就不再使用了，而django.newforms也終于可以名正言順的叫做：django.forms。

表單框架最主要的用法是，為每一個將要處理的HTML的``

`` 定義一個Form類。在這個例子中，我們只有一個`` `` ，因此我們只需定義一個Form類。這個類可以存在于任何地方，甚至直接寫在`` views.py`` 文件里也行，但是社區的慣例是把Form類都放到一個文件中：forms.py。在存放`` views.py`` 的目錄中，創建這個文件，然后輸入：

from django import forms

class ContactForm(forms.Form):

subject = forms.CharField()

email = forms.EmailField(required=False)

message = forms.CharField()

這看上去簡單易懂，并且很像在模塊中使用的語法。表單中的每一個字段(域)作為Form類的屬性，被展現成Field類。這里只用到CharField和EmailField類型。每一個字段都默認是必填。要使email成為可選項，我們需要指定required=False。

讓我們鉆研到Python解釋器里面看看這個類做了些什么。它做的第一件事是將自己顯示成HTML：

>>> from contact.forms import ContactForm

>>> f = ContactForm()

>>> print f

<tr><th><label for="id_subject">Subject:</label></th><td><input type="text" name="subject" id="id_subject" /></td></tr>

<tr><th><label for="id_email">Email:</label></th><td><input type="text" name="email" id="id_email" /></td></tr>

<tr><th><label for="id_message">Message:</label></th><td><input type="text" name="message" id="id_message" /></td></tr>

為了便于訪問，Django用`` `` 標志，為每一個字段添加了標簽。這個做法使默認行為盡可能合適。

默認輸出按照HTML的<`` table`` >格式，另外有一些其它格式的輸出：

>>> print f.as_ul()

<li><label for="id_subject">Subject:</label> <input type="text" name="subject" id="id_subject" /></li>

<li><label for="id_email">Email:</label> <input type="text" name="email" id="id_email" /></li>

<li><label for="id_message">Message:</label> <input type="text" name="message" id="id_message" /></li>

>>> print f.as_p()

<p><label for="id_subject">Subject:</label> <input type="text" name="subject" id="id_subject" /></p>

<p><label for="id_email">Email:</label> <input type="text" name="email" id="id_email" /></p>

<p><label for="id_message">Message:</label> <input type="text" name="message" id="id_message" /></p>

請注意，標簽

、

這些類方法只是一般情況下用于快捷顯示完整表單的方法。你同樣可以用HTML顯示個別字段：

、的開閉合標記沒有包含于輸出當中，這樣你就可以添加額外的行或者自定義格式。

>>> print f['subject']

<input type="text" name="subject" id="id_subject" />

>>> print f['message']

<input type="text" name="message" id="id_message" />

Form對象做的第二件事是校驗數據。為了校驗數據，我們創建一個新的對Form象，并且傳入一個與定義匹配的字典類型數據：

>>> f = ContactForm({'subject': 'Hello', 'email': 'adrian@example.com', 'message': 'Nice site!'})

一旦你對一個Form實體賦值，你就得到了一個綁定form：

>>> f.is_bound

True

調用任何綁定form的is_valid()方法，就可以知道它的數據是否合法。我們已經為每個字段傳入了值，因此整個Form是合法的：

>>> f.is_valid()

True

如果我們不傳入email值，它依然是合法的。因為我們指定這個字段的屬性required=False：

>>> f = ContactForm({'subject': 'Hello', 'message': 'Nice site!'})

>>> f.is_valid()

True

但是，如果留空subject或message，整個Form就不再合法了：

>>> f = ContactForm({'subject': 'Hello'})

>>> f.is_valid()

False

>>> f = ContactForm({'subject': 'Hello', 'message': ''})

>>> f.is_valid()

False

你可以逐一查看每個字段的出錯消息：

>>> f = ContactForm({'subject': 'Hello', 'message': ''})

>>> f['message'].errors

[u'This field is required.']

>>> f['subject'].errors

[]

>>> f['email'].errors

[]

每一個邦定Form實體都有一個errors屬性，它為你提供了一個字段與錯誤消息相映射的字典表。

>>> f = ContactForm({'subject': 'Hello', 'message': ''})

>>> f.errors

{'message': [u'This field is required.']}

最終，如果一個Form實體的數據是合法的，它就會有一個可用的cleaned_data屬性。這是一個包含干凈的提交數據的字典。 Django的form框架不但校驗數據，它還會把它們轉換成相應的Python類型數據，這叫做清理數據。

>>> f = ContactForm({subject': Hello, email: adrian@example.com, message: Nice site!})

>>> f.is_valid()

True

>>> f.cleaned_data

{message': uNice site!, email: uadrian@example.com, subject: uHello}