Skip to main content

Table/data-grid framework for Django

Project description

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.

Features:

  • 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.

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

Example

Start by adding django_tables2 to your INSTALLED_APPS setting like this:

INSTALLED_APPS = (
    ...,
    'django_tables2',
)

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.

Project details


Release history Release notifications | RSS feed

This version

1.7.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-tables2-1.7.0.tar.gz (2.8 MB view details)

Uploaded Source

File details

Details for the file django-tables2-1.7.0.tar.gz.

File metadata

File hashes

Hashes for django-tables2-1.7.0.tar.gz
Algorithm Hash digest
SHA256 7812417c2b3a91c3417de34833c6e50319f46b669190e97ea80dd25d42d60f57
MD5 e8ce72d3bbc511e448e5ec92a321fd47
BLAKE2b-256 10de42610085f281e4e93cd1ad282f7c996f5f1a0ed61bc96eed6d3618d2c0a1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page