Python框架之Django學習筆記（十七）

本文轉載自查看原文 2014-11-01 12:58 882 Django/ Python

Django框架之表單（續二）

　　今天的這篇博客將是Django學習筆記博客的最后一篇，基本每周最少一篇的Django框架學習，堅持到今天也實屬不易，當然了，這個框架的學習僅僅是Django框架的基礎部分了，不過也夠我們平時搭個簡易的網站或者個人博客什么的。希望通過這一系列的博文，讓大家也從中體會到Django框架的魅力所在，如果很不幸，你沒有體會到，只能說明我水平有限，無法將如此美麗的事物展示與你，閑話少說，下面開始繼續學習表單的相關知識。

編寫Contact表單

　　這個表單包括用戶提交的反饋信息，一個可選的e-mail回信地址。當這個表單提交並且數據通過驗證后，系統將自動發送一封包含題用戶提交的信息的e-mail給站點工作人員。

　　我們從contact_form.html模板入手：

 1 <html>
 2 <head>
 3     <title>Contact us</title>
 4 </head>
 5 <body>
 6     <h1>Contact us</h1>
 7 
 8     {% if errors %}
 9         <ul>
10             {% for error in errors %}
11             <li>{{ error }}</li>
12             {% endfor %}
13         </ul>
14     {% endif %}
15 
16     <form action="/contact/" method="post">
17         <p>Subject: <input type="text" name="subject"></p>
18         <p>Your e-mail (optional): <input type="text" name="email"></p>
19         <p>Message: <textarea name="message" rows="10" cols="50"></textarea></p>
20         <input type="submit" value="Submit">
21     </form>
22 </body>
23 </html>

　　我們定義了三個字段：主題，e-mail和反饋信息。除了e-mail字段為可選，其他兩個字段都是必填項。注意，這里我們使用method=”post”而非method=”get”，因為這個表單會有一個服務器端的操作：發送一封e-mail。並且，我們復制了前一個模板search_form.html中錯誤信息顯示的代碼。

　　如果我們順着上一節編寫search()視圖的思路，那么一個contact()視圖代碼應該像這樣：

 1 from django.core.mail import send_mail
 2 from django.http import HttpResponseRedirect
 3 from django.shortcuts import render_to_response
 4 
 5 def contact(request):
 6     errors = []
 7     if request.method == 'POST':
 8         if not request.POST.get('subject', ''):
 9             errors.append('Enter a subject.')
10         if not request.POST.get('message', ''):
11             errors.append('Enter a message.')
12         if request.POST.get('email') and '@' not in request.POST['email']:
13             errors.append('Enter a valid e-mail address.')
14         if not errors:
15             send_mail(
16                 request.POST['subject'],
17                 request.POST['message'],
18                 request.POST.get('email', 'noreply@example.com'),
19                 ['siteowner@example.com'],
20             )
21             return HttpResponseRedirect('/contact/thanks/')
22     return render_to_response('contact_form.html',
23         {'errors': errors})

　　現在來分析一下以上的代碼：

確認request.method的值是’POST’。用戶瀏覽表單時這個值並不存在，當且僅當表單被提交時這個值才出現。（在后面的例子中，request.method將會設置為’GET’，因為在普通的網頁瀏覽中，瀏覽器都使用GET，而非POST）。判斷request.method的值很好地幫助我們將表單顯示與表單處理隔離開來。
我們使用request.POST代替request.GET來獲取提交過來的數據。這是必須的，因為contact_form.html里表單使用的是method=”post”。如果在視圖里通過POST獲取數據，那么request.GET將為空。
這里，有兩個必填項，subject 和 message，所以需要對這兩個進行驗證。注意，我們使用request.POST.get()方法，並提供一個空的字符串作為默認值；這個方法很好的解決了鍵丟失與空數據問題。
雖然email非必填項，但如果有提交她的值則我們也需進行驗證。我們的驗證算法相當的薄弱，僅驗證值是否包含@字符。在實際應用中，需要更為健壯的驗證機制（Django提供這些驗證機制，稍候我們就會看到）。
我們使用了django.core.mail.send_mail函數來發送e-mail。這個函數有四個必選參數：主題，正文，寄信人和收件人列表。 send_mail是Django的EmailMessage類的一個方便的包裝，EmailMessage類提供了更高級的方法，比如附件，多部分郵件，以及對於郵件頭部的完整控制。
注意，若要使用send_mail()函數來發送郵件，那么服務器需要配置成能夠對外發送郵件，並且在Django中設置出站服務器地址。參見規范：http://docs.djangoproject.com/en/dev/topics/email/
當郵件發送成功之后，我們使用HttpResponseRedirect對象將網頁重定向至一個包含成功信息的頁面。包含成功信息的頁面這里留給讀者去編寫（很簡單一個視圖/URL映射/一份模板即可），但是我們要解釋一下為何重定向至新的頁面，而不是在模板中直接調用render_to_response()來輸出。
原因就是：若用戶刷新一個包含POST表單的頁面，那么請求將會重新發送造成重復。這通常會造成非期望的結果，比如說重復的數據庫記錄；在我們的例子中，將導致發送兩封同樣的郵件。如果用戶在POST表單之后被重定向至另外的頁面，就不會造成重復的請求了。
我們應每次都給成功的POST請求做重定向。這就是web開發的最佳實踐。

　　contact()視圖可以正常工作，但是她的驗證功能有些復雜。想象一下假如一個表單包含一打字段，我們真的將必須去編寫每個域對應的if判斷語句？

　　另外一個問題是表單的重新顯示。若數據驗證失敗后，返回客戶端的表單中各字段最好是填有原來提交的數據，以便用戶查看哪里出現錯誤（用戶也不需再次填寫正確的字段值）。我們可以手動地將原來的提交數據返回給模板，並且必須編輯HTML里的各字段來填充原來的值。　

 1 # views.py
 2 
 3 def contact(request):
 4     errors = []
 5     if request.method == 'POST':
 6         if not request.POST.get('subject', ''):
 7             errors.append('Enter a subject.')
 8         if not request.POST.get('message', ''):
 9             errors.append('Enter a message.')
10         if request.POST.get('email') and '@' not in request.POST['email']:
11             errors.append('Enter a valid e-mail address.')
12         if not errors:
13             send_mail(
14                 request.POST['subject'],
15                 request.POST['message'],
16                 request.POST.get('email', `'noreply@example.com`_'),
17                 [`'siteowner@example.com`_'],
18             )
19             return HttpResponseRedirect('/contact/thanks/')
20     return render_to_response('contact_form.html', {
21         'errors': errors,
22         **'subject': request.POST.get('subject', ''),**
23         **'message': request.POST.get('message', ''),**
24         **'email': request.POST.get('email', ''),**
25     })
26 
27 # contact_form.html
28 
29 <html>
30 <head>
31     <title>Contact us</title>
32 </head>
33 <body>
34     <h1>Contact us</h1>
35 
36     {% if errors %}
37         <ul>
38             {% for error in errors %}
39             <li>{{ error }}</li>
40             {% endfor %}
41         </ul>
42     {% endif %}
43 
44     <form action="/contact/" method="post">
45         <p>Subject: <input type="text" name="subject" **value="{{ subject }}"** ></p>
46         <p>Your e-mail (optional): <input type="text" name="email" **value="{{ email }}"** ></p>
47         <p>Message: <textarea name="message" rows="10" cols="50">**{{ message }}**</textarea></p>
48         <input type="submit" value="Submit">
49     </form>
50 </body>
51 </html>

在視圖中使用Form類

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

　　表單框架最主要的用法是，為每一個將要處理的HTML的“<Form>"定義一個 Form類。在這個例子中，我們只有一個" <Form>"，因此我們只需定義一個 Form類。這個類可以存在於任何地方，甚至直接寫在"views.py"文件里也行，但是社區的慣例是把 Form類都放到一個文件中： forms.py。在存放" views.py" 的目錄中，創建這個文件，然后輸入：　

1 from django import forms
2 
3 class ContactForm(forms.Form):
4     subject = forms.CharField()
5     email = forms.EmailField(required=False)
6     message = forms.CharField()

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

　　接下來，我們在使用它重寫contact表單應用：　

 1 # views.py
 2 
 3 from django.shortcuts import render_to_response
 4 from mysite.contact.forms import ContactForm
 5 
 6 def contact(request):
 7     if request.method == 'POST':
 8         form = ContactForm(request.POST)
 9         if form.is_valid():
10             cd = form.cleaned_data
11             send_mail(
12                 cd['subject'],
13                 cd['message'],
14                 cd.get('email', 'noreply@example.com'),
15                 ['siteowner@example.com'],
16             )
17             return HttpResponseRedirect('/contact/thanks/')
18     else:
19         form = ContactForm()
20     return render_to_response('contact_form.html', {'form': form})
21 
22 # contact_form.html
23 
24 <html>
25 <head>
26     <title>Contact us</title>
27 </head>
28 <body>
29     <h1>Contact us</h1>
30 
31     {% if form.errors %}
32         <p style="color: red;">
33             Please correct the error{{ form.errors|pluralize }} below.
34         </p>
35     {% endif %}
36 
37     <form action="" method="post">
38         <table>
39             {{ form.as_table }}
40         </table>
41         <input type="submit" value="Submit">
42     </form>
43 </body>
44 </html>

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

私人定制Form設計

　　修改form的顯示的最快捷的方式是使用CSS。尤其是錯誤列表，可以增強視覺效果。自動生成的錯誤列表精確的使用“<ul class=”errorlist”>”，這樣，我們就可以針對它們使用CSS。下面的CSS讓錯誤更加醒目了：

 1 <style type="text/css">
 2     ul.errorlist {
 3         margin: 0;
 4         padding: 0;
 5     }
 6     .errorlist li {
 7         background-color: red;
 8         color: white;
 9         display: block;
10         font-size: 10px;
11         margin: 0 0 3px;
12         padding: 4px 5px;
13     }
14 </style>

　　雖然，自動生成HTML是很方便的，但是在某些時候，你會想覆蓋默認的顯示。 {{form.as_table}}和其它的方法在開發的時候是一個快捷的方式，form的顯示方式也可以在form中被方便地重寫。

　　每一個字段部件(<input type=”text”>, <select>, <textarea>, 或者類似)都可以通過訪問{{form.字段名}}進行單獨的渲染。

 1 <html>
 2 <head>
 3     <title>Contact us</title>
 4 </head>
 5 <body>
 6     <h1>Contact us</h1>
 7 
 8     {% if form.errors %}
 9         <p style="color: red;">
10             Please correct the error{{ form.errors|pluralize }} below.
11         </p>
12     {% endif %}
13 
14     <form action="" method="post">
15         <div class="field">
16             {{ form.subject.errors }}
17             <label for="id_subject">Subject:</label>
18             {{ form.subject }}
19         </div>
20         <div class="field">
21             {{ form.email.errors }}
22             <label for="id_email">Your e-mail address:</label>
23             {{ form.email }}
24         </div>
25         <div class="field">
26             {{ form.message.errors }}
27             <label for="id_message">Message:</label>
28             {{ form.message }}
29         </div>
30         <input type="submit" value="Submit">
31     </form>
32 </body>
33 </html>

　　{{ form.message.errors }} 會在 <ul class="errorlist"> 里面顯示，如果字段是合法的，或者form沒有被綁定，就顯示一個空字符串。我們還可以把 form.message.errors 當作一個布爾值或者當它是list在上面做迭代，例如：

 1 <div class="field{% if form.message.errors %} errors{% endif %}">
 2     {% if form.message.errors %}
 3         <ul>
 4         {% for error in form.message.errors %}
 5             <li><strong>{{ error }}</strong></li>
 6         {% endfor %}
 7         </ul>
 8     {% endif %}
 9     <label for="id_message">Message:</label>
10     {{ form.message }}
11 </div>

　　在校驗失敗的情況下, 這段代碼會在包含錯誤字段的div的class屬性中增加一個”errors”，在一個有序列表中顯示錯誤信息。

　　好了，Django的學習筆記到此就正式結束了，基本的網站搭建管理這點點知識已經足以，恩，基本情況就是醬紫了。

　　PS:本博客歡迎轉發，但請注明博客地址及作者~

　　博客地址：http://www.cnblogs.com/voidy/

　　<。)#)))≦

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。

猜您在找 Python框架之Django學習筆記（四） Python學習筆記（八）--Django框架 Python & Django 學習筆記 (8)Django框架學習-python模擬Django框架 python Web框架 Django學習(1) Python Django 學習（一）【Django 框架初探】 python Django 學習筆記（一）—— Django安裝 Python學習筆記第二十七周（Bootstrap） Python-Django框架學習筆記——第一課：Hello World python Django 學習筆記（三）—— 模版的使用