1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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
52
53
54
55
56
57
58
|
Class Based Generic Mixins
==========================
Django-tables2 comes with a class based view mixin: `.SingleTableMixin`.
It makes it trivial to incorporate a table into a view/template.
The following view parameters are supported:
- ``table_class`` –- the table class to use, e.g. ``SimpleTable``
- ``table_data`` (or ``get_table_data()``) -- the data used to populate the table
- ``context_table_name`` -- the name of template variable containing the table object
- ``table_pagination`` (or ``get_table_pagination``) -- pagination
options to pass to `.RequestConfig`. Set ``table_pagination=False``
to disable pagination.
For example:
.. sourcecode:: python
from django_tables2 import SingleTableView
class Person(models.Model):
first_name = models.CharField(max_length=200)
last_name = models.CharField(max_length=200)
class PersonTable(tables.Table):
class Meta:
model = Simple
class PersonList(SingleTableView):
model = Person
table_class = PersonTable
The template could then be as simple as:
.. sourcecode:: django
{% load render_table from django_tables2 %}
{% render_table table %}
Such little code is possible due to the example above taking advantage of
default values and `.SingleTableMixin`'s eagerness at finding data sources
when one isn't explicitly defined.
.. note::
If you need more than one table on a page, use `.SingleTableView` and use
`.get_context_data` to initialize the other tables and add them to the
context.
.. note::
You don't have to base your view on `ListView`, you're able to mix
`SingleTableMixin` directly.
|
