django-tables2 - An app for creating HTML tables
Latest commit 2bf8fd3 Sep 30, 2016 @ralgozino ralgozino committed with jieter Updated bootstrap template (#381)
* Update README.rst

* Fixes #335

* Rebase with master

* Removed items count and now using i18n in bootstrap theme.

* Trying to fix CI errors

* Added SemanticUI Example

* Added screenshots for bootstrap and semantic

* Better footer. Dynamic colspan and changed disabled button of page count to item

* Dropped semantic.css and code improvements.

* Code cleaning and refactoring of fake data creation.

* Screenshots Update

* Make sure tests passes. Replaced etree by html in parse.

* Added semantic-ui tests.


django-tables2 - An app for creating HTML tables

Latest PyPI version Travis CI

django-tables2 simplifies the task of turning sets of data into HTML tables. It has native support for pagination and sorting. It does for HTML tables what django.forms does for HTML forms. e.g.

An example table rendered using django-tables2 An example table rendered using django-tables2 and bootstrap theme An example table rendered using django-tables2 and semantic-ui theme

Its features include:

  • Any iterable can be a data-source, but special support for Django querysets is included.
  • The builtin UI does not rely on JavaScript.
  • Support for automatic table generation based on a Django model.
  • Supports custom column functionality via subclassing.
  • Pagination.
  • Column based table sorting.
  • Template tag to enable trivial rendering to HTML.
  • Generic view mixin.

About the app:


Start by adding django_tables2 to your INSTALLED_APPS setting like this:


Creating a table for a model Simple is as simple as:

import django_tables2 as tables

class SimpleTable(tables.Table):
    class Meta:
        model = Simple

This would then be used in a view:

def simple_list(request):
    queryset = Simple.objects.all()
    table = SimpleTable(queryset)
    return render(request, 'simple_list.html', {'table': table})

And finally in the template:

{% load django_tables2 %}
{% render_table table %}

This example shows one of the simplest cases, but django-tables2 can do a lot more! Check out the documentation for more details.