{"title":"Banyak obyek mixin","version":"2.1","locale":"id","docname":"ref/class-based-views/mixins-multiple-object","url":"/id/2.1/ref/class-based-views/mixins-multiple-object/","canonical":"https://djangodocs.dev/id/2.1/ref/class-based-views/mixins-multiple-object/","summary":"MultipleObjectMixin Link to this heading # class django.views.generic.list. MultipleObjectMixin Link to this definition # Sebuah mixin yang dapat digunakan…","html":"

Banyak obyek mixinLink to this heading#

\n
\n

MultipleObjectMixinLink to this heading#

\n
\n
\nclass django.views.generic.list.MultipleObjectMixinLink to this definition#
\n

Sebuah mixin yang dapat digunakan memperlihatkan daftar dari obyek.

\n

Jika paginate_by ditentukan, Django akan memberikan nomor hasil dikembalikan oleh ini. Anda dapat menentukan nomor halaman di URL di satu atau dua cara:

\n
    \n

  • Gunakan parameter page di URLconf. Sebagai contoh, ini adalah apa URLconf anda mungkin terlihat seperti:

    \n
    Code
    path('objects/page<int:page>/', PaginatedView.as_view()),\n
    \n
    • \n

  • Lewatkan nomor halaman melalui parameter string-permintaan page. Sebagai contoh, sebuah URL akan terlihat seperti ini:

    \n
    Code
    /objects/?page=3\n
    \n
    • \n
\n

Nilai-nilai ini dan daftar adalah berdasarkan-1, bukan berdasarkan-0, jadi halaman pertama akan diwakili sebagai halaman 1.

\n

Untuk lebih pada pemberian nomor, baca pagination documentation.

\n

Seperti kasus khusus, anda juga diizinkan menggunakan last sebagai sebuah nilai untuk page:

\n
Code
/objects/?page=last\n
\n

Ini mengizinkan anda mengakses halaman akhir dari hasil tanpa pertama harus menentukan seberapa banyak halaman ada.

\n

Catat bahwa page harus antara nomor halaman sah atau nilai last; nilai lain apapun untuk page akan menghasilkan di kesalahan 404.

\n

Perpanjang

\n\n

Cara dan Atribut

\n
\n
\nallow_emptyLink to this definition#
\n

Sebuah boolean menentukan apakah memperlihatkan halaman jika tidak ada obyek tersedia. Jika ini adalah False dan tidak ada obyek tersedia, tampilan akan memunculkan sebuah 404 daripada memperlihatkan sebuah halaman kosong. Secara awalan, ini adalah True.

\n
\n\n
\n
\nmodelLink to this definition#
\n

Model yang tampilan ini akan menampilkan data. Menentukan model = Foo secara efektif sama seperti menentukan queryset = Foo.objects.all(), dimana objects berdiri untuk default manager Foo.

\n
\n\n
\n
\nquerysetLink to this definition#
\n

Sebuah QuerySet yang mewakili obyek-obyek. Jika disediakan, nilai dari queryset menggantikan nilai disediakan untuk model.

\n\n
\n\n
\n
\norderingLink to this definition#
\n

Sebuah string atau daftar dari string menentukan urutan untuk memberlakukan ke queryset. Nilai-nilai sah adalah sama seperti itu untuk order_by().

\n
\n\n
\n
\npaginate_byLink to this definition#
\n

Sebuah integer menentukan seberapa banyak obyek-obyek harus diperlihatkan per halaman. Jika ini diberikan, tampilan akan memberikan nomor obyek-obyek dengan paginate_by obyek-obyek per halaman. Tampilan akan mengharapkan antara sebuah parameter string permintaan page (melalui request.GET) atau sebuah variabel page ditentukan di URLconf.

\n
\n\n
\n
\npaginate_orphansLink to this definition#
\n

Sebuah integer menentukan nomor dari obyek-obyek "overflow" halaman terakhir dapat diisi. Ini memperpanjang paginate_by batasan pada halaman terakhir sampai pada paginate_orphans, untuk menjaga halaman terakhir dari memiliki sangat kecil nomor dari obyek-obyek.

\n
\n\n
\n
\npage_kwargLink to this definition#
\n

Sebuah string menentukan nama digunakan untuk parameter halaman. Tampilan akan mengharapkan parameter ini untuk tersedia antara sebagai sebuah parameter string permintaan (melalui request.GET) atau sebagai sebuah variabel kwarg ditentukan di URLconf. Awalan ke page.

\n
\n\n
\n
\npaginator_classLink to this definition#
\n

Kelas penomoran digunakan untuk menomorkan halaman. Secara awalan, django.core.paginator.Paginator digunakan. Jika penyesuaian kelas penomoran tidak mempunyai antarmuka pembangun sama seperti django.core.paginator.Paginator, anda akan juga butuh menyediakan sebuah penerapan untuk get_paginator().

\n
\n\n
\n
\ncontext_object_nameLink to this definition#
\n

Menandakan nama dari variabel untuk digunakan di konteks.

\n
\n\n
\n
\nget_queryset()Link to this definition#
\n

Dapatkan daftar dari barang-barang untuk tampilan ini. Ini harus berupa sebuah perulangan dan mungkin sebuah queryset (dimana perilaku queryset-tertentu akan diadakan).

\n
\n\n
\n
\nget_ordering()Link to this definition#
\n

Mengembalikan sebuah string (atau perulangan dari string) yang menentukan urutan yang akan diberlakukan ke queryset.

\n

Mengembalikan ordering secara awalan.

\n
\n\n
\n
\npaginate_queryset(queryset, page_size)Link to this definition#
\n

Mengembalikan 4-tuple mengandung (paginator, page, object_list, is_paginated).

\n

DIbangun dengan menomori queryset kedalam halaman dari ukuran page_size. Jika permintaan mengandung sebuah argumen page, antara sebagau URL tertangkap atau sebagai argumen GET, object_list akan berhubungan ke obyek-obyek dari halaman itu.

\n
\n\n
\n
\nget_paginate_by(queryset)Link to this definition#
\n

Mengembalikan sejumlah barang-barang untuk menomorkan, atau None untuk tidak penomoran. Secara awalan ini cukup mengembalikan nilai dari paginate_by.

\n
\n\n
\n
\nget_paginator(queryset, per_page, orphans=0, allow_empty_first_page=True)Link to this definition#
\n

Mengembalikan sebuah instance dari penomor digunakan untuk tampilan ini. Secara awalan, instasiasi sebuah instance dari paginator_class.

\n
\n\n
\n
\nget_paginate_orphans()Link to this definition#
\n

Sebuah integer menentukan sejumlah obyek-obyek "overflow" halaman terakhir dapat diisi. Secara awalan ini cukup mengembalikan nilai dari paginate_orphans.

\n
\n\n
\n
\nget_allow_empty()Link to this definition#
\n

Mengembalikan sebuah boolean menentukan apakah memperlihatkan halaman jika tidak ada obyek tersedia. Jika metode ini mengembalikan False dan tidak ada obyek tersedia, tampilan akan memunculkan sebuah 404 daripada memperlihatkan sebuah halaman kosong. Secara awalan, ini adalah True.

\n
\n\n
\n
\nget_context_object_name(object_list)Link to this definition#
\n

Mengembalikan nama variabel konteks yang akan digunakan mewadahi daftar data yang tampilan ini dimanipulasi. Jika object_list adalah sebuah queryset dari obyek-obyek Django dan context_object_name tidak disetel, nama konteks akan menjadi model_name dari the model yang queryset disusun dari, dengan postfix '_list' ditambahkan. Sebagai contoh, model Article akan mempunyai sebuah obyek konteks bernama article_list.

\n
\n\n
\n
\nget_context_data(**kwargs)Link to this definition#
\n

Mengembalikan data konteks untuk memperlihatkan daftar dari obyek.

\n
\n\n

Konteks

\n
    \n

  • object_list: Daftar dari obyek-obyek yang tampilan ini diperlihatkan. Jika context_object_name ditentukan, variabel itu akan juga disetel di konteks, dengan nilai sama seperti object_list.

    • \n

  • is_paginated: Sebuah boolean mewakili apakah hasil dinomorkan. Khususnya, ini disetel menjadi False jika tidak ada ukuran halaman telah ditentukan, atau jika obyek-obyek tersedia tidak menjangkau banyak halaman.

    • \n

  • paginator: Sebuah instance dari django.core.paginator.Paginator. Jika halaman tidak dinomorkan, variabel konteks ini akan menjadi None.

    • \n

  • page_obj: Sebuah instance dari django.core.paginator.Page. Jika halaman tidak dinomorkan, variabel konteks ini akan menjadi None.

    • \n
\n
\n\n
\n
\n

MultipleObjectTemplateResponseMixinLink to this heading#

\n
\n
\nclass django.views.generic.list.MultipleObjectTemplateResponseMixinLink to this definition#
\n

Sebuah kelas mixin yang melakukan membangun tanggapan berdasarkan-cetakan untuk tampilan yang beroperasi diatas daftar dari instance obyek. Diwajibkan bahwa tampilan itu campurkan dengan self.object_list tersedia, daftar dari instance obyek yang tampilan beroperasi. self.object_list mungkin, tetapi tidak diwajibkan menjadi, sebuah QuerySet.

\n

Perpanjang

\n\n

Cara dan Atribut

\n
\n
\ntemplate_name_suffixLink to this definition#
\n

Akhiran ditambahkan ke calon nama cetakan dibangkitkan-otomatis. Awalan akhiran adalah _list.

\n
\n\n
\n
\nget_template_names()Link to this definition#
\n

Mengembalikan daftar dari calon nama-nama cetakan. Mengembalikan daftar berikut:

\n
    \n

  • nilai dari template_name pada tampilan (jika disediakan)

    • \n

  • <app_label>/<model_name><template_name_suffix>.html

    • \n
\n
\n\n
\n\n
","rootId":"multiple-object-mixins","toc":[{"title":"MultipleObjectMixin","anchor":"multipleobjectmixin","children":[]},{"title":"MultipleObjectTemplateResponseMixin","anchor":"multipleobjecttemplateresponsemixin","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Acuan API","url":"/id/2.1/ref/"},{"docname":"ref/class-based-views/index","title":"API tampilan berdasarkan-kelas siap-pakai","url":"/id/2.1/ref/class-based-views/"},{"docname":"ref/class-based-views/mixins","title":"Mixin tampilan berdasarkan-kelas","url":"/id/2.1/ref/class-based-views/mixins/"}],"prev":{"docname":"ref/class-based-views/mixins-single-object","title":"Mixin obyek tunggal","url":"/id/2.1/ref/class-based-views/mixins-single-object/"},"next":{"docname":"ref/class-based-views/mixins-editing","title":"Menyunting mixin","url":"/id/2.1/ref/class-based-views/mixins-editing/"},"formats":{"html":"/id/2.1/ref/class-based-views/mixins-multiple-object/","markdown":"/id/2.1/ref/class-based-views/mixins-multiple-object.md","json":"/id/2.1/ref/class-based-views/mixins-multiple-object.json"},"source":"https://github.com/django/django/blob/stable/2.1.x/docs/ref/class-based-views/mixins-multiple-object.txt","official":"https://docs.djangoproject.com/id/2.1/ref/class-based-views/mixins-multiple-object/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}