Model

Uses a django MTV model as table data source, and queries all data in database by default. See model in table options for details.

QuerySet

Similiar to Model, but pass queryset when you initialize the table instance instead of defining model option. Basically, it is used to filter or sort data you want to display in table.

Models:

    # models.py
    class Person(models.Model):
        name = models.CharField(max_length=100)

Tables:

    # tables.py
    from models import Person
    from table import Table
        from table.columns import Column

    class PersonTable(Table):
        id = Column(field='id')
        name = Column(field='name')

Views:

    # views.py
    from django.shortcuts import render
    from models import Person
    from app.tables import PersonTable

    def people(request):
        people = PersonTable(Person.objects.all())
        return render(request, "index.html", {'people': people})

Dict-List

Use a list of dictionaries as table data source. Fields declared in columns correspond to the dictionary keys.

Tables:

    # tables.py
    from table import Table
    from table.columns import Column

    class PersonTable(Table):
        id = Column(field='id')
        name = Column(field='name')

Views:

    # views.py
    from django.shortcuts import render
    from app.tables import PersonTable

    def people(request):
        data = [{'id': 1, 'name': 'John'}, {'id': 2, 'name': 'Tom'}]
        people = PersonTable(data)
        return render(request, "index.html", {'people': people})

Built-in Ajax

For large amounts of data, loading them on front-end entirely is impossible. So, django-table provides a simle option ‘ajax’ to load data from the server-side asynchronously.

Note that once toggling ajax, the model option is necessary. Django-table will do paging/searching/sorting based on ModelClass.objects.all().

Urls:

    # urls.py
    urlpatterns = patterns('',
        url(r'^table/', include(table.urls')),
    )

Tables:

    # tables.py
    from table import Table
    from table.columns import Column

    class PersonTable(Table):
        id = Column(field='id')
        name = Column(field='name')

        class Meta:
            model = Person
            ajax = True

Custom Ajax

If you want to customize base data, use ajax_source option and implement your own Class-based View by subclassing FeedDataView.

Tables:

    # tables.py
    class PersonTable(Table):
        id = Column(field='id')
        name = Column(field='name')

        class Meta:
            model = Person
            ajax = True
            ajax_source = reverse_lazy('table_data')

Urls:

    # urls.py
    urlpatterns = patterns('',
        url(r'^table/data/$', MyDataView.as_view(), name='table_data'),
    )

Views:

    # views.py
    from table.views import FeedDataView
    from app.tables import PersonTable

    class MyDataView(FeedDataView):

        token = PersonTable.token

        def get_queryset(self):
            return super(MyDataView, self).get_queryset().filter(id__gt=5)