django-sortable-listview

django的ListView的扩展，提供排序。

功能

• 与django内置的分页一起工作。
• 包含分页和排序按钮的模板和CSS（或只需使用context_data自行构建）。
• 为活动排序添加箭头以显示排序方向。
• 知道下一个排序是什么（即，如果您已经按标题以一个方向排序，再次点击标题按钮/链接将按另一个方向排序）。
• 允许您指定列表的默认排序（默认为-id）以及每个可排序字段的排序。
• 修改查询集，让数据库进行排序。
• 维护额外的查询字符串（可配置）

需求

以下是支持的版本。旧版本也可能工作。

* Python (2.7, 3.5, 3.6, 3.7)
* Django (1.11, 2.1, 2.2)

安装

使用pip：

pip install django-sortable-listview

如果您想使用提供的模板和CSS，请在您的django设置中将'sortable_listview'添加到INSTALLED_APPS中。

要了解如何在您的应用程序中包含CSS和模板，请查看示例项目。CSS只是标准的bootstrap。

示例项目

要运行示例项目，首先请确保django和django-sortable-listview在您的python路径上。例如，在虚拟环境中：

pip install django
pip install django-sortable-listview

然后从您的克隆文件夹中：

cd example_project
python manage.py migrate
python manage.py runserver

您应该在localhost:8000看到示例项目。提供了一个包含一些示例内容的数据库。用户名和密码是admin/admin

开发和测试

对于您的开发设置：

pip install -r requirements-dev.txt

要运行测试：

tox

当您在进行开发时，可能不想运行整个tox套件。在这种情况下，取消注释requirements-dev.txt中的额外行，但请勿提交这些更改。（欢迎提出更好的管理方法）

变更日志

0.43

• 修复Python 3回归问题，以移除params（感谢@bw-aus, @ghost, @birdsarah）
• 将tox更新为使用Django 2.2（感谢@birdsarah）

0.42

• 修复Django 1.11的问题
• 修复编码问题（感谢@bw-aus）
• 向模板添加CSS类（感谢@JanMalte）
• 修复缺失的翻译（感谢@JanMalte和@valentjedi）
• 保留允许的排序字段的顺序（感谢@tooreht）

0.41

• 进一步改进查询字符串（感谢@fle）
• 针对Django 1.8进行测试

0.40

• 添加Python 3支持
• 添加tox & travis以测试所有变体
• 更新许可证为MIT

0.30

• 添加保留其他查询字符串的支持（感谢@fle）
• 确保在1.6和1.7中运行测试（感谢@fle）