Tutorial ini mulai dimana Tutorial 2 tinggalkan. Kami sedang melanjutkan aplikasi jejak pendapat jaringan dan akan fokus membuat antarmuka umum -- "tampilan".
\nSebuah tampilan adalah "jenis" dari halaman Jaringan di aplikasi Django yang umumnya melayani fungsi khusus dan mempunyai cetakan khusus. Sebagai contoh, di aplikasi blog, anda mungkin mempunyai tampilan berikut:
\nHalaman rumah Blog -- menampilkan sedikit masukan terakhir.
Halaman "rincian" masukan -- halaman permalink untuk masukan tunggal.
Halaman arsip berdasarkan-tahun -- menampilkan semua bulan dengan masukan di tahun yang diberikan.
Halaman arsip berdasarkan-bulan -- menampilkan semua hari dengan masukan di bulan yang diberikan.
Halaman arsip berdasarkan-hari -- menampilkan semua masukan di hari yang diberikan.
Tindakan komentar -- menangani penempatan komentar pada masukan yang diberikan.
Di aplikasi jejak pendapat kami, kami akan mempunyai empat tampilan berikut:
\nHalaman "index" pertanyaan -- menampilkan sedikit pertanyaan terakhir.
Halaman "index" pertanyaan -- menampilkan teks pertanyaan, dengan tidak ada hasil tetapi dengan formulir untuk memilih.
Halaman "hasil" pertanyaan -- menampilkan hasil untuk pertanyaan tertentu.
Tindakan pilih -- menangani pemilihan untuk pilihan tertentu di pertanyaan tertentu.
Di DJango, halaman jaringan dan isi lain dikirimkan oleh tampilan. Setiap tampilan diwakilkan dengan fungsi Phyton sederhana (atau cara, di kasus ini dari tampilan berbasis-kelas). Django akan memilih tampilan dengan menguji URL yang diminta (agar akurat, bagian dari URL setelah nama ranah).
\nSekarang waktu anda di jaringan anda mungkin telah menemukan keindahan seperti "ME2/Sites/dirmod.asp?sid=&type=gen&mod=Core+Pages&gid=A6CD4967199A42D9B65B1B". Anda akan dipersilahkan untuk mengetahui bahwa Django mengizinkan kami lebih banyak elegan corak URL dari pada itu.
\nCorak URL adalah formulir umum sederhana dari URL - sebagai contoh: /newsarchive/<year>/<month>/.
Untuk mendapatkan URL pada tampilan, Django menggunakan apa yang dikenal sebagai 'URLconfs'. URLconfs memetakan corak URL (digambarkan sebagai regular expression) pada tampilan
\nTutorial ini menyediakan perintah dasar dalam penggunaan URLconfs, dan anda dapat mengacu ke django.core.urlresolvers untuk informasi lebih.
Sekarang mari kita menambahkan tampilan lebih pada polls/views.py. Tampilan ini sedikit berbeda karena mereka mangambil argumen:
polls/views.pydef detail(request, question_id):\n return HttpResponse("You're looking at question %s." % question_id)\n\ndef results(request, question_id):\n response = "You're looking at the results of question %s."\n return HttpResponse(response % question_id)\n\ndef vote(request, question_id):\n return HttpResponse("You're voting on question %s." % question_id)\nIkat tampilan baru ini ke dalam modul polls.urls dengan menambahkan pemanggilan berikut url():
polls/urls.pyfrom django.conf.urls import url\n\nfrom . import views\n\nurlpatterns = [\n # ex: /polls/\n url(r'^$', views.index, name='index'),\n # ex: /polls/5/\n url(r'^(?P<question_id>[0-9]+)/$', views.detail, name='detail'),\n # ex: /polls/5/results/\n url(r'^(?P<question_id>[0-9]+)/results/$', views.results, name='results'),\n # ex: /polls/5/vote/\n url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),\n]\nLihatlah di perambah anda, pada "/polls/34/". Itu akan menjalankan cara detail() dan menampilkan ID apapun anda sediakan di URL. Coba "/polls/34/results/" dan "/polls/34/vote/" juga -- ini akan menampilkan hasil placeholder dan halaman pemilihan.
When somebody requests a page from your website -- say, "/polls/34/", Django\nwill load the mysite.urls Python module because it's pointed to by the\nROOT_URLCONF setting. It finds the variable named urlpatterns\nand traverses the regular expressions in order. After finding the match at\n'^polls/', it strips off the matching text ("polls/") and sends the\nremaining text -- "34/" -- to the 'polls.urls' URLconf for further\nprocessing. There it matches r'^(?P<question_id>[0-9]+)/$', resulting in a\ncall to the detail() view like so:
detail(request=<HttpRequest object>, question_id='34')\nBagian question_id='34'` datang dari (?P<question_id>[0-9]+). Menggunakan tanda kurung disekitar corak "menangkap" teks dicocokkan oleh corak itu dan dikirim sebagai argumen ke fungsi tampilan; ?P<question_id> menentukan nama yang akan digunakan untuk mencirikan corak dicocokkan; dan [0-9]+ adalah regular expression untuk mencocokkan urutan angka (yaitu sebuah angka).
Karena corak URL adalah regular expression, mereka sangat tidak terbatas pada apa yang anda dapat lakukan dengan mereka. Dan tidak perlu menambahkan rancangan jelek URL seperti .html -- meskipun anda ingin, dalamhal ini anda dapat melakukan sesuatu seperti ini:
url(r'^polls/latest\\.html$', views.index),\nTetapi, jangan melakukan itu. Itu lucu.
\nSetiap tampilan bertanggung jawab untuk melakukan satu dari dua hal: mengembalikan sebuah obyek HttpResponse mengandung isi untuk halaman diminta, atau menimbulkan sebuah pengecualian seperti Http404. Sisanya terserah anda.
Tampilan anda dapat membaca rekaman dari basisdata, atau tidak. Dia dapat menggunakan cetakan sistem seperti DJango -- atau sistem cetakan Phyton pihak-ketiga -- atau tidak. Dia dapat membangkitkan berkas PDF, mengeluarkan XML, membuat berkas ZIP dengan cepat, apapun anda inginkan, menggunakan pustaka Phyton apapun anda inginkan.
\nSemua Django inginkan adalah HttpResponse. Atau sebuah pengecualian.
Karena sangat nyaman, mari kita menggunakan API basisdata Django sendiri, yang akan melingkupi di Tutorial 2. Ini satu tikaman pada tampilan index() baru, yang menampilka pertanyaan jejak pendapat 5 terakhir di sistem, dipisahkan oleh koma, menurut tanggal penerbitan:
polls/views.pyfrom django.http import HttpResponse\n\nfrom .models import Question\n\n\ndef index(request):\n latest_question_list = Question.objects.order_by('-pub_date')[:5]\n output = ', '.join([q.question_text for q in latest_question_list])\n return HttpResponse(output)\n\n# Leave the rest of the views (detail, results, vote) unchanged\nTidak ada masalah disini, meskipun: rancangan halaman adalah kode-keras di tampilan. Jika anda ingin merubah cara tampilan halaman, anda harus menyunting kode Phyton ini. Jadi mari kita menggunakan sistem cetakan Django untuk memisahkan rancangan dari Phyton dengan membuat cetakan yang tampilan dapat digunakan.
\nPertama, buat direktori disebut templates di direktori``polls``. Django akan mencari cetakan disana.
Pengaturan TEMPLATES proyek anda menggambarkan bagaimana Django akan memuat dan membaut halaman. Pengaturan awal berkas mengkonfigurasikan backend DjangoTemplates yang pilihan APP_DIRS adalah disetel ke True. Berdasarkan kaidah DjangoTemplates mencari untuk subdirektori :cetakan" dalam setiap INSTALLED_APPS.
Dalam direktori templates anda telah buat, buat direktori lain disebut polls, dan dalam itu buat sebuah berkas disebut index.html. Dengan kata lain, cetakan anda harus di polls/templates/polls/index.html. Karena bagaimana pemuat cetakan app_directories bekerja seperti yang digambarkan diatas, anda dapat mengacu ke cetakan ini dalam Django hanya sebagai polls/index.html.
Taruh kode berikut di cetakan itu:
\npolls/templates/polls/index.html{% if latest_question_list %}\n <ul>\n {% for question in latest_question_list %}\n <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>\n {% endfor %}\n </ul>\n{% else %}\n <p>No polls are available.</p>\n{% endif %}\nSekarang mari kita perbaharui tampilan index di polls/views.py untuk menggunakan cetakan:
polls/views.pyfrom django.http import HttpResponse\nfrom django.template import loader\n\nfrom .models import Question\n\n\ndef index(request):\n latest_question_list = Question.objects.order_by('-pub_date')[:5]\n template = loader.get_template('polls/index.html')\n context = {\n 'latest_question_list': latest_question_list,\n }\n return HttpResponse(template.render(context, request))\nKode memuat cetakan disebut polls/index.html dan melewatkannya ke konteks. Konteks adalah kamus variabel cetakan pemetaan dinamai untuk obyek Phyton.
Muat halaman dengan menunjuk perambah anda pada "/polls/", dan anda akan melihat daftar-bullet mengandung pertanyaan "Ada apa" dari Tutorial 2. Tautan menunjuk ke halaman rincian pertanyaan.
\nrender()Link to this heading#Itu adalah dialek umum untuk memuat cetakan, isi konteks dan mengembalikan sebuah obyek HttpResponse dengan hasil dari cetakan dibuat. Django menyediakan jalan pintas. Disini tampilan index() penuh, ditulis kembali:
polls/views.pyfrom django.shortcuts import render\n\nfrom .models import Question\n\n\ndef index(request):\n latest_question_list = Question.objects.order_by('-pub_date')[:5]\n context = {'latest_question_list': latest_question_list}\n return render(request, 'polls/index.html', context)\nCatat bahwa sekali kami telah selesaikan ini di semua tampilan ini, kami tidak lagi butuh mengimpor loader dan HttpResponse (anda akan ingin menjaga HttpResponse jika anda masih mempunyai potongan cara untuk detail, results, dan vote).
Fungsi render() mengambil permintaan obyek sebagai argumen pertamanya, nama cetakan sebagai argumen keduanya dan kamus sebagai pilihan argumen ketiganya. Dia mengembalikan sebuah obyek HttpResponse dari cetakan diberikan dibangun dengan konteks yang diberikan.
Sekarang, mari kita mengerjakan tampilan rincian pertanyaan -- halaman yang menampilkan teks pertanyaan untuk jejak pertanyaan yang diberikan. Inilah tampilan:
\npolls/views.pyfrom django.http import Http404\nfrom django.shortcuts import render\n\nfrom .models import Question\n# ...\ndef detail(request, question_id):\n try:\n question = Question.objects.get(pk=question_id)\n except Question.DoesNotExist:\n raise Http404("Question does not exist")\n return render(request, 'polls/detail.html', {'question': question})\nKonsep baru disini: Tapilan memunculkan pengecualian Http404 jika sebuah pertanyaan dengan ID diminta tidak ada.
Kami akan berunding apa anda dapat taruh di cetakan polls/detail.html itu kemudian, tetapi jika anda suka mendapatkan cepat contoh diatas bekerja, sebuah berkas mengandung hanya:
polls/templates/polls/detail.html{{ question }}\nakan membantu anda mulai untuk sekarang.
\nget_object_or_404()Link to this heading#Adalah dialek umum untuk menggunakan get() dan menimbulkan Http404 jika obyek tidak ada. Django menyediakan jalan pintas. Ini tampilan detail()`, ditulis kembali:
polls/views.pyfrom django.shortcuts import get_object_or_404, render\n\nfrom .models import Question\n# ...\ndef detail(request, question_id):\n question = get_object_or_404(Question, pk=question_id)\n return render(request, 'polls/detail.html', {'question': question})\nFungsi get_object_or_404() mengambil model Django sebagai argumen pertamanya dan angka sewenang-wenang dari kata kunci argumen, yang dia melalui fungsi get() dari pengelola model. Dia menimbulkan Http404 jika obyek tidak ada.
Terdapat juga sebuah fungsi get_list_or_404(), yang bekerja hanya sebagai get_object_or_404() -- kecuali menggunakan filter() daripada get(). Itu memunculkan Http404 jika daftar kosong.
Kembali ke tampilan detail() untuk aplikasi jejak pendapat kami. Diberikan variabel konteks question, disini adalah apa cetakan polls/detail.html mungkin kelihatan seperti:
polls/templates/polls/detail.html<h1>{{ question.question_text }}</h1>\n<ul>\n{% for choice in question.choice_set.all %}\n <li>{{ choice.choice_text }}</li>\n{% endfor %}\n</ul>\nSistem cetakan menggunakan sintaks dot-lookup untuk mengakses atribut variabel. Di contoh dari {{ question.question_text }}, pertama Django melakukan lookup perkamusan pada obyek question. Kegagalan itu, dia mencoba sebuah atribut lookup -- yang bekerja, di kasus ini. Jika atribut lookup telah gagal, dia akan mencoba list-index lookup.
Pemanggilan-cara terjadi di {% for %} loop: question.choice_set.all adalah ditafsirkan sebagai kode Phyton question.choice_set.all(), yang mengembalikan berulang obyek Choice dan cocok untuk digunakan di etiket {% for %}.
Lihat panduan cetakan untuk lebih tentang cetakan.
\nIngat, ketika kami menulis tautan ke pertanyaan di cetakan polls/index.html, tautan sebagian dikodekan keras seperti ini:
<li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>\nMasalah dengan kode keras ini, pendekatam pasangan-erat adalah bahwa dia menjadi menantang untuk merubah URL di proyek anda dengan banyak cetakan. Bagaimanapun, sejak anda menentukan nama argumen di fungsi url() di modul polls.urls, anda dapat memindahkan kepercayaan pada jalur URL khusus ditentukan di konfigurasi url anda dengan menggunakan etiket cetakan {% url %}:
<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>\nCara ini bekerja adalah dengan mencari pengertian URL seperti yang ditentukan di modul polls.urls. Anda dapat melihat sebenarnya dimana nama URL dari 'rincian' ditentukan dibawah:
...\n# the 'name' value as called by the {% url %} template tag\nurl(r'^(?P<question_id>[0-9]+)/$', views.detail, name='detail'),\n...\nJika anda ingin merubah URL dari tampilan rinci jejak pendapat ke sesuatu lain, mungkin ke sesuatu seperti polls/specifics/12/ dibandingkan melakukannya di cetakan (atau cetakan-cetakan) anda akan merubahnya di polls/urls.py:
...\n# added the word 'specifics'\nurl(r'^specifics/(?P<question_id>[0-9]+)/$', views.detail, name='detail'),\n...\nProyek tutorial hanya punya satu aplikasi, polls. Di proyek Django nyata, mungkin ada lima, sepuluh, dua puluh aplikasi atau lebih. Bagaimana Django membedakan nama URL diantara mereka? Sebagai contoh, aplikasi polls mempunyai tampilan detail, dan mungkin sebuah aplikasi di proyek sama yaitu untuk sebuah blog. Bagaimana satu membuatnya sehingga Django mengetahui tampilan aplikasi mana untuk membuat untuk sebuah url ketika menggunakan etiket cetakan {% url %}?
Jawabannya adalah menambahkan namespace ke URLconf anda. Di berkas polls/urls.py, lanjutkan dan tambah app_name untuk mengatur namespace aplikasi:
polls/urls.pyfrom django.conf.urls import url\n\nfrom . import views\n\napp_name = 'polls'\nurlpatterns = [\n url(r'^$', views.index, name='index'),\n url(r'^(?P<question_id>[0-9]+)/$', views.detail, name='detail'),\n url(r'^(?P<question_id>[0-9]+)/results/$', views.results, name='results'),\n url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),\n]\nSekarang rubah cetakan polls/index.html anda dari:
polls/templates/polls/index.html<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>\nuntuk menunjuk tampilan rincian namespace:
\npolls/templates/polls/index.html<li><a href="{% url 'polls:detail' question.id %}">{{ question.question_text }}</a></li>\nKetika anda nyaman dengan tampilan penulisan, baca bagian 4 dari tutorial ini untuk mempelajari tentang bentuk sederhana pengolahan dan tampilan umum.
\n