Django初級手冊4-表單與通用檢視

Solon Tan發表於2014-02-27

表單的編寫

1. detail.html模版的編寫

<h1>{{ poll.question }}</h1>

{% if error_message %}<p><strong>{{ error_message }}</strong></p>{% endif %}

<form action="{% url 'polls:vote' poll.id %}" method="post">
{% csrf_token %}
{% for choice in poll.choice_set.all %}
    <input type="radio" name="choice" id="choice{{ forloop.counter }}" value="{{ choice.id }}" />
    <label for="choice{{ forloop.counter }}">{{ choice.choice_text }}</label><br />
{% endfor %}
<input type="submit" value="Vote" />
</form>

錯誤資訊是為了沒有選擇直接提交做準備的。
純HTML表單的提交如下:

<form action="/example/html/form_action.asp" method="get">
  <input type="radio" name="sex" value="male" /> Male<br />
  <input type="radio" name="sex" value="female" /> Female<br />
  <input type="submit" value="Submit" />
</form>
  • 上述程式碼中,action呼叫vote url從而呼叫vote的檢視函式。
  • input的名字相同,可以提供單項選擇。
  • label的for標籤可和input的id標籤對應,label標籤就是為了對input元素進行標註。
  • forloop.counter相當於C語言中for的計數器i。
  • 所有的POST表單的提交都應該注意安全,{% csrf_token %}可保證該POST只接受內建的URL

2. view.py的修改

from django.shortcuts import get_object_or_404, render
from django.http import HttpResponseRedirect, HttpResponse
from django.core.urlresolvers import reverse
from polls.models import Choice, Poll
# ...
def vote(request, poll_id):
    p = get_object_or_404(Poll, pk=poll_id)
    try:
        selected_choice = p.choice_set.get(pk=request.POST['choice'])
    except (KeyError, Choice.DoesNotExist):
        # Redisplay the poll voting form.
        return render(request, 'polls/detail.html', {
            'poll': p,
            'error_message': "You didn't select a choice.",
        })
    else:
        selected_choice.votes += 1
        selected_choice.save()
        # Always return an HttpResponseRedirect after successfully dealing
        # with POST data. This prevents data from being posted twice if a
        # user hits the Back button.
        return HttpResponseRedirect(reverse('polls:results', args=(p.id,)))
  • request.POST是一個類似詞典結構的結構,可以接受來自POST強求表單的資訊,它的值總受字串,request.GET也是相同的方式。
  • 如果POST中沒有choice的資訊,則會重定向到vote頁面,並有警告提示。
  • 在成功處理POST資料後,都應該重定向,這在所有的網路開發中都是適用的。原因在註釋中。
  • reverse函式可以避免生硬難看的URL,和URL中的形式保持一致。

3. results的編寫

view.py中

from django.shortcuts import get_object_or_404, render

def results(request, poll_id):
    poll = get_object_or_404(Poll, pk=poll_id)
    return render(request, 'polls/results.html', {'poll': poll})  

results.html

<h1>{{ poll.question }}</h1>

<ul>
{% for choice in poll.choice_set.all %}
    <li>{{ choice.choice_text }} -- {{ choice.votes }} vote{{ choice.votes|pluralize }}</li>
{% endfor %}
</ul>

<a href="{% url 'polls:detail' poll.id %}">Vote again?</a>

使用通用檢視

是否選用通用檢視的方法是應該一開始就決定的,教程採用這種順序是因為更好的說明概念。
可以發現detail()和results()函式是十分相似的。

1. 修正URLS

from django.conf.urls import patterns, url

from polls import views

urlpatterns = patterns('',
    url(r'^$', views.IndexView.as_view(), name='index'),
    url(r'^(?P<pk>\d+)/$', views.DetailView.as_view(), name='detail'),
    url(r'^(?P<pk>\d+)/results/$', views.ResultsView.as_view(), name='results'),
    url(r'^(?P<poll_id>\d+)/vote/$', views.vote, name='vote'),
)

2. 修正views

from django.shortcuts import get_object_or_404, render
from django.http import HttpResponseRedirect
from django.core.urlresolvers import reverse
from django.views import generic

from polls.models import Choice, Poll

class IndexView(generic.ListView):
    template_name = 'polls/index.html'
    context_object_name = 'latest_poll_list'

    def get_queryset(self):
        """Return the last five published polls."""
        return Poll.objects.order_by('-pub_date')[:5]


class DetailView(generic.DetailView):
    model = Poll
    template_name = 'polls/detail.html'


class ResultsView(generic.DetailView):
    model = Poll
    template_name = 'polls/results.html'

def vote(request, poll_id):
    ....

ListView與DetailView

  1. 二者分別為顯示物件列表和顯示指定物件的詳細資訊。
  2. 每個通用模組需要知道其索要顯示的資料(model)
  3. DetailView期望獲取主鍵pk,因此修改了poll_id為pk
  4. DetailView預設的模版名為<app name>/<model name>_detail.html
  5. ListView預設的模版名為<app name>/<model name>_list.html
  6. DetailView預設的context_object_name為model名子的小寫,所以不需要重新指定
  7. ListView預設的context_object_name為model名子的小寫_list,所以需要重新指定

相關文章