此包与jquery插件(http://http://datatables.net/)一起使用,并支持使用(http://datatables.net/plug-ins/api)进行状态保存检测。该包由一个基于类的视图和一个用于从模型中呈现表数据的实用程序的小集合组成。
dtv-custom的Python项目详细描述
数据表视图
此包与jquery插件DataTables一起使用,并支持使用fnSetFilteringDelay进行状态保存检测。该包由一个基于类的视图和一个用于从模型中呈现表数据的实用程序的小集合组成。
依赖关系:
- python 2.7/3.5或更高版本
- Django>;=1.11
- dateutil库用于灵活、容错的数据解析。
- jQuery>;=2
- dataTables.js>;=1.10
入门
安装软件包:
pip install django-datatable-view
添加到INSTALLED_APPS
(这样就可以发现默认模板和js),并像django一样使用DatatableView
:
# settings.pyINSTALLED_APPS=['datatableview',# ...]# views.pyfromdatatableview.viewsimportDatatableViewclassZeroConfigurationDatatableView(DatatableView):model=MyModel
使用模板上下文中提供的{{ datatable }}
呈现表并从服务器ajax初始化:
<!-- myapp/mymodel_list.html --><!-- Load dependencies --><scriptsrc="https://code.jquery.com/jquery-3.3.1.min.js"integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="crossorigin="anonymous"></script><linkrel="stylesheet"href="https://cdn.datatables.net/1.10.19/css/jquery.dataTables.min.css"><scripttype="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 --><scripttype="text/javascript"charset="utf8"src="{% static 'js/datatableview.js' %}"></script><scripttype="text/javascript">$(function(){datatableview.initialize('.datatable');});</script><!-- Render the table skeleton, includes the .datatable class for the on-ready initializer. --> {{ datatable }}
功能一目了然
DatatableView
,替换ListView
的一个下拉列表,允许为将在页面上呈现的数据表指定选项。MultipleDatatableView
用于在单个视图上配置多个数据表规范ModelForm
类声明性表设计。- 支持
ValuesQuerySet
执行模式而不是对象实例 - 请求之间的QuerySet缓存
- 可自定义的表格标题
- 复合列(表示多个模型字段的列)
- 由方法或回调而不是模型字段支持的列
- 简单相关字段
- 自动搜索和排序支持
- 完全控制单元格内容(HTML,处理原始值)
- 搜索表中不存在的数据字段
- 支持dt_rowdata
- 完整json响应对象的自定义挂钩
- 下拉式X-可编辑支持,每列
- 可自定义的表格模板
- 易于引导集成
- 允许所有普通datatables.js和x-editable javascript选项
- 小型通用列标记处理器库
- 完整测试套件
文档和现场演示
阅读http://django-datatable-view.readthedocs.org上的模块文档。
一个公共的现场演示服务器正在工作中。对于0.8版,我们将继续在http://django-datatable-view.appspot.com/上保持实时演示站点的活动状态。请注意,0.8并不反映项目的当前状态或方向。
您可以使用几个常见的安装步骤从包含的示例项目本地运行实时演示。
$ 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
示例项目配置为使用本地sqlite3数据库,并依赖于django-datatable-view
应用程序本身,该应用程序在python路径中可用,只需从分布式目录根运行该项目即可。
作者
- 秋季情人节
- 史蒂文·克拉斯
版权和许可
版权所有(c)2012-2018关键能源解决方案。保留所有权利
根据apache许可证2.0版(以下简称“许可证”)授权; 除非符合许可证,否则您不得使用本作品。 您可以在许可证文件中获得许可证的副本,或访问:
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意,否则软件 根据许可证分发是按“原样”分发的, 无任何明示或默示的保证或条件。 有关管理权限的特定语言和 许可下的限制。