This package is used in conjunction with the jQuery plugin DataTables, and supports state-saving detection with fnSetFilteringDelay. The package consists of a class-based view, and a small collection of utilities for rendering table data from models.
Features at a glance
DatatableView, a drop-in replacement for
ListViewthat allows options to be specified for the datatable that will be rendered on the page.
MultipleDatatableViewfor configurating multiple Datatable specifications on a single view
ModelForm-like declarative table design.
- Support for
ValuesQuerySetexecution mode instead of object instances
- Queryset caching between requests
- Customizable table headers
- Compound columns (columns representing more than one model field)
- Columns backed by methods or callbacks instead of model fields
- Easy related fields
- Automatic search and sort support
- Total control over cell contents (HTML, processing of raw values)
- Search data fields that aren't present on the table
- Support for DT_RowData
- Customization hook for full JSON response object
- Drop-in x-editable support, per-column
- Customizable table templates
- Easy Bootstrap integration
- Small library of common column markup processors
- Full test suite
Documentation and Live Demos
Read the module documentation at http://django-datatable-view.readthedocs.org.
You can also run the live demos locally from the included example project, using a few setup steps.
$ git clone https://github.com/pivotal-energy-solutions/django-datatable-view.git $ cd django-datatable-view $ mkvirtualenv datatableview (datatableview)$ pip install -r requirements.txt (datatableview)$ datatableview/tests/example_project/manage.py syncdb (datatableview)$ datatableview/tests/example_project/manage.py loaddata initial_data_modern (datatableview)$ datatableview/tests/example_project/manage.py runserver
The example project is configured to use a local sqlite3 database, and relies only on the
django-datatable-view app itself. In fact, it disables the normal
django.contrib apps (except for
django.contrib.staticfiles, so that the dev server can serve the included statics) and disables all default middleware except for
CsrfViewMiddleware (the latter for supporting the x-editable demonstrations.)
- Tim Valenta
- Steven Klass
Copyright and license
Copyright (c) 2012-2015 Pivotal Energy Solutions. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.