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