API tampilan berdasarkan-kelas siap-pakaiLink to this heading

Acuan API tampilan berdasarkan-kelas. Untuk bahan perkenalan, lihat panduan topik Tampilan berdasarkan-kelas.

SpesifikasiLink to this heading

Setiap permintaan dilayani oleh tampilan berbasis-kelas mempunyai keadaan berdiri sendiri; karena itu, itu aman menyimpan variabel keadaan pada instance (yaitu, self.foo = 3 adalah pekerjaan benang-aman).

Sebuah tampilan berdasarkan-kelas disebarkan kedalam corak URL menggunakan metodekelas as_view():

Code
urlpatterns = [
    url(r'^view/$', MyView.as_view(size=42)),
]

Argumen dilewatkan kedalam as_view() akan diberikan ke atas instance yang digunakan untuk melayani sebuah permintaan. Menggunakan contoh sebelumnya, ini berarti bahwa setiap permintaan pada MyView dapat menggunakan self.size. Argumen-argumen harus berhubungan ke atribut-atribut yang sudah ada pada kelas (mengembalikan True pada pemeriksaan hasattr).

Tampilan Dasar vs UmumLink to this heading

Dasar tampilan berdasarkan-kelas dapat dianggap sebagai tampilan parent, yang dapat digunakan oleh mereka sendiri atau diwariskan dari. Mereka mungkin tidak menyediakan semua kemampuan diwajibkan untuk proyek, dalam hal ini ada Mixin yang memperpanjang tampilan dasar apa dapat lakukan.

Tampilan umum Django adalah untuk mengembangkan dari tampilan dasar tersebut, dan kami kembangkan sebagai sebuah jalan pintas untuk corak penggunaan umum seperti memperlihatkan rincian dari sebuah obyek. Mereka mengambil dialek dan corak umum tertentu ditemukan di tampilan pengembangan dan abstrak mereka sehingga anda dapat dengan cepat menulis tampilan umum dari data tanpa harus mengulangi anda sendiri.

Kebanyakan tampilan umum membutuhkan kunci queryset, yang adalah instance QuerySet; lihat Membuat query untuk informasi lebih tentang obyek QuerySet.