Skip to main content

This package is used in conjunction with the jQuery plugin (http://http://datatables.net/), and supports state-saving detection with (http://datatables.net/plug-ins/api). The package consists of a class-based view, and a small collection of utilities for rendering table data from models.

Project description

Datatable View

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.

PyPI Downloads PyPI Version Build Status Documentation Status

Dependencies:

Getting Started

Install the package:

pip install django-datatable-view

Add to INSTALLED_APPS (so default templates and js can be discovered), and use the DatatableView like a Django ListView:

# settings.py
INSTALLED_APPS = [
    'datatableview',
    # ...
]


# views.py
from datatableview.views import DatatableView
class ZeroConfigurationDatatableView(DatatableView):
    model = MyModel

Use the {{ datatable }} provided in the template context to render the table and initialize from server ajax:

<!-- myapp/mymodel_list.html -->

<!-- Load dependencies -->
<script src="https://code.jquery.com/jquery-3.3.1.min.js"
        integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="
        crossorigin="anonymous"></script>
<link rel="stylesheet" href="https://cdn.datatables.net/1.10.19/css/jquery.dataTables.min.css">
<script type="text/javascript" charset="utf8" src="https://cdn.datatables.net/1.10.19/js/jquery.dataTables.min.js"></script>

<!-- Load js for initializing tables via their server-side options -->
<script type="text/javascript" charset="utf8" src="{% static 'js/datatableview.js' %}"></script>
<script type="text/javascript">
    $(function(){
        datatableview.initialize($('.datatable'));
    });
</script>

<!-- Render the table skeleton, includes the .datatable class for the on-ready initializer. -->
{{ datatable }}

Features at a glance

  • DatatableView, a drop-in replacement for ListView that allows options to be specified for the datatable that will be rendered on the page.
  • MultipleDatatableView for configurating multiple Datatable specifications on a single view
  • ModelForm-like declarative table design.
  • Support for ValuesQuerySet execution 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
  • Allows all normal dataTables.js and x-editable Javascript options
  • 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.

A public live demo server is in the works. For version 0.8, we will continue to keep the live demo site alive at http://django-datatable-view.appspot.com/ Please note that 0.8 does not reflect the current state or direction of the project.

You can run the live demos locally from the included example project, using a few common 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 migrate
(datatableview)$ datatableview/tests/example_project/manage.py loaddata initial_data
(datatableview)$ datatableview/tests/example_project/manage.py runserver

The example project is configured to use a local sqlite3 database, and relies on the django-datatable-view app itself, which is made available in the python path by simply running the project from the distributed directory root.

Authors

  • Autumn Valenta
  • Steven Klass

Copyright and license

Copyright 2011-2021 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:

http://www.apache.org/licenses/LICENSE-2.0

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.

Project details


Download files

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

Source Distribution

django-datatable-view-2.1.6.tar.gz (50.5 kB view details)

Uploaded Source

Built Distribution

django_datatable_view-2.1.6-py2.py3-none-any.whl (59.9 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-datatable-view-2.1.6.tar.gz.

File metadata

  • Download URL: django-datatable-view-2.1.6.tar.gz
  • Upload date:
  • Size: 50.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.0

File hashes

Hashes for django-datatable-view-2.1.6.tar.gz
Algorithm Hash digest
SHA256 b84ba6809b35b1d018eb502b3fed5b9dec219ed87120ee54f04a601551a341af
MD5 ba33fc60fad9700f04fedff50d915c19
BLAKE2b-256 05ccf26f6bf8cf70110fe40d86039ac01a6f407260eca1ea67ad56e529a39071

See more details on using hashes here.

File details

Details for the file django_datatable_view-2.1.6-py2.py3-none-any.whl.

File metadata

  • Download URL: django_datatable_view-2.1.6-py2.py3-none-any.whl
  • Upload date:
  • Size: 59.9 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.0

File hashes

Hashes for django_datatable_view-2.1.6-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 74b4ac9e99ebba50f5558b62434a21fa28c681b0c9f40b875c96ff497aeba11b
MD5 a9e40f31a14c4da04efd1702b8fc647a
BLAKE2b-256 3eae026ee8aee1ad6b3d06407cccb2c3036d47a6b319b5b03986d221059e48bf

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