class MultipleObjectMixin
from django.views.generic.list import MultipleObjectMixin
A mixin for views manipulating multiple objects.
Ancestors (MRO)
- MultipleObjectMixin
- ContextMixin
Attributes
Defined in | |
---|---|
allow_empty = True
|
MultipleObjectMixin |
context_object_name = None
|
MultipleObjectMixin |
model = None
|
MultipleObjectMixin |
ordering = None
|
MultipleObjectMixin |
page_kwarg = 'page'
|
MultipleObjectMixin |
paginate_by = None
|
MultipleObjectMixin |
paginate_orphans = 0
|
MultipleObjectMixin |
paginator_class = <class 'django.core.paginator.Paginator'>
|
MultipleObjectMixin |
queryset = None
|
MultipleObjectMixin |
Methods
def
get_allow_empty(self):
MultipleObjectMixin
¶
def
get_allow_empty(self):
MultipleObjectMixin
¶
Returns ``True`` if the view should display empty lists, and ``False`` if a 404 should be raised instead.
108 109 110 111 112 113 | def get_allow_empty(self):
"""
Returns ``True`` if the view should display empty lists, and ``False``
if a 404 should be raised instead.
"""
return self.allow_empty
|
def
get_context_data(self, **kwargs):
¶
def
get_context_data(self, **kwargs):
¶
MultipleObjectMixin
Get the context for this view.
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 | def get_context_data(self, **kwargs):
"""
Get the context for this view.
"""
queryset = kwargs.pop('object_list', self.object_list)
page_size = self.get_paginate_by(queryset)
context_object_name = self.get_context_object_name(queryset)
if page_size:
paginator, page, queryset, is_paginated = self.paginate_queryset(queryset, page_size)
context = {
'paginator': paginator,
'page_obj': page,
'is_paginated': is_paginated,
'object_list': queryset
}
else:
context = {
'paginator': None,
'page_obj': None,
'is_paginated': False,
'object_list': queryset
}
if context_object_name is not None:
context[context_object_name] = queryset
context.update(kwargs)
return super(MultipleObjectMixin, self).get_context_data(**context)
|
ContextMixin
22 23 24 25 | def get_context_data(self, **kwargs):
if 'view' not in kwargs:
kwargs['view'] = self
return kwargs
|
def
get_context_object_name(self, object_list):
MultipleObjectMixin
¶
def
get_context_object_name(self, object_list):
MultipleObjectMixin
¶
Get the name of the item to be used in the context.
115 116 117 118 119 120 121 122 123 124 | def get_context_object_name(self, object_list):
"""
Get the name of the item to be used in the context.
"""
if self.context_object_name:
return self.context_object_name
elif hasattr(object_list, 'model'):
return '%s_list' % object_list.model._meta.model_name
else:
return None
|
def
get_ordering(self):
MultipleObjectMixin
¶
def
get_ordering(self):
MultipleObjectMixin
¶
Return the field or fields to use for ordering the queryset.
55 56 57 58 59 | def get_ordering(self):
"""
Return the field or fields to use for ordering the queryset.
"""
return self.ordering
|
def
get_paginate_by(self, queryset):
MultipleObjectMixin
¶
def
get_paginate_by(self, queryset):
MultipleObjectMixin
¶
Get the number of items to paginate by, or ``None`` for no pagination.
86 87 88 89 90 | def get_paginate_by(self, queryset):
"""
Get the number of items to paginate by, or ``None`` for no pagination.
"""
return self.paginate_by
|
def
get_paginate_orphans(self):
MultipleObjectMixin
¶
def
get_paginate_orphans(self):
MultipleObjectMixin
¶
Returns the maximum number of orphans extend the last page by when paginating.
101 102 103 104 105 106 | def get_paginate_orphans(self):
"""
Returns the maximum number of orphans extend the last page by when
paginating.
"""
return self.paginate_orphans
|
def
get_paginator(self, queryset, per_page, orphans=0, allow_empty_first_page=True, **kwargs):
MultipleObjectMixin
¶
def
get_paginator(self, queryset, per_page, orphans=0, allow_empty_first_page=True, **kwargs):
MultipleObjectMixin
¶
Return an instance of the paginator for this view.
92 93 94 95 96 97 98 99 | def get_paginator(self, queryset, per_page, orphans=0,
allow_empty_first_page=True, **kwargs):
"""
Return an instance of the paginator for this view.
"""
return self.paginator_class(
queryset, per_page, orphans=orphans,
allow_empty_first_page=allow_empty_first_page, **kwargs)
|
def
get_queryset(self):
MultipleObjectMixin
¶
def
get_queryset(self):
MultipleObjectMixin
¶
Return the list of items for this view. The return value must be an iterable and may be an instance of `QuerySet` in which case `QuerySet` specific behavior will be enabled.
26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 | def get_queryset(self):
"""
Return the list of items for this view.
The return value must be an iterable and may be an instance of
`QuerySet` in which case `QuerySet` specific behavior will be enabled.
"""
if self.queryset is not None:
queryset = self.queryset
if isinstance(queryset, QuerySet):
queryset = queryset.all()
elif self.model is not None:
queryset = self.model._default_manager.all()
else:
raise ImproperlyConfigured(
"%(cls)s is missing a QuerySet. Define "
"%(cls)s.model, %(cls)s.queryset, or override "
"%(cls)s.get_queryset()." % {
'cls': self.__class__.__name__
}
)
ordering = self.get_ordering()
if ordering:
if isinstance(ordering, six.string_types):
ordering = (ordering,)
queryset = queryset.order_by(*ordering)
return queryset
|
def
paginate_queryset(self, queryset, page_size):
MultipleObjectMixin
¶
def
paginate_queryset(self, queryset, page_size):
MultipleObjectMixin
¶
Paginate the queryset, if needed.
61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 | def paginate_queryset(self, queryset, page_size):
"""
Paginate the queryset, if needed.
"""
paginator = self.get_paginator(
queryset, page_size, orphans=self.get_paginate_orphans(),
allow_empty_first_page=self.get_allow_empty())
page_kwarg = self.page_kwarg
page = self.kwargs.get(page_kwarg) or self.request.GET.get(page_kwarg) or 1
try:
page_number = int(page)
except ValueError:
if page == 'last':
page_number = paginator.num_pages
else:
raise Http404(_("Page is not 'last', nor can it be converted to an int."))
try:
page = paginator.page(page_number)
return (paginator, page, page.object_list, page.has_other_pages())
except InvalidPage as e:
raise Http404(_('Invalid page (%(page_number)s): %(message)s') % {
'page_number': page_number,
'message': str(e)
})
|