django-admin属性介绍（1）

django-admin属性介绍（1）

使用django-admin，自定义ModelAdmin or AdminSite时需要了解的一些定义方法的使用，可以对应方法快速理解并应用开发。

ModelAdmin属性选项:

1. ModelAdmin.empty_value_display：如果一个字段的值是None，一个空字符串或没有元素的可迭代，则Django将显示-（破折号）。您可以使用AdminSite.empty_value_display
2. ModelAdmin.exclude:如果提供此属性，则应为要从表单中排除的字段名称列表。
3. ModelAdmin.fields:使用该fields选项可以在“添加”和“更改”页面上的表单中进行简单的布局更改
4. ModelAdmin.fieldsets:设置fieldsets以控制管理员“添加”和“更改”页面的布局。
5. ModelAdmin.filter_horizontal:默认情况下，ManyToManyField管理站点中的a 会显示一个。但是，选择多个项目时可能很难使用多选框。在此列表中添加 ，将使用漂亮的，不引人注意的JavaScript“过滤器”界面，该界面允许在选项中进行搜索。
6. ModelAdmin.filter_vertical:与相同filter_horizontal，但使用过滤器界面的垂直显示，其中未选择选项的框出现在已选择选项的框上方。
7. ModelAdmin.form:默认情况下，ModelForm将为您的模型动态创建一个。它用于创建在两个添加/更改页面上显示的表单。
8. ModelAdmin.formfield_overrides: 这提供了一种快捷方法来覆盖Field在管理员中使用的某些 选项。 最常见的用途formfield_overrides是为特定类型的字段添加自定义窗口小部件,字典中的键是实际的字段类，而不是字符串。
9. ModelAdmin.list_display:设置list_display以控制在管理员的更改列表页面上显示哪些字段。以显示__str__()每个对象的表示形式。ManyToManyField不支持字段
10. ModelAdmin.admin_order_field:支持查询查找以按相关模型上的值排序
11. ModelAdmin.list_display_links:使用list_display_links以控制是否和字段 list_display应与“变”的页面对象
12. ModelAdmin.list_editable:为模型上字段名称的列表，该列表将允许在更改列表页面上进行编辑。也就是说，其中列出的字段将在 list_editable更改列表页面上显示为表单小部件，从而允许用户一次编辑和保存多行。
13. ModelAdmin.list_filter:设置list_filter以激活管理员更改列表页面右侧栏中的过滤器，
14. ModelAdmin.list_max_show_all: 为控制在“显示全部”管理员更改列表页面上可以显示多少个项目。
15. ModelAdmin.list_per_page:为控制在每个分页的管理员更改列表页面上显示多少个项目
16. ModelAdmin.list_select_related:为告诉Django select_related()在管理更改列表页面上检索对象列表时使用。这样可以节省大量数据库查询。
17. ModelAdmin.ordering:以指定应如何在Django管理视图中对对象列表进行排序。这应该是与模型ordering参数格式相同的列表或元组。
18. ModelAdmin.paginator:用于分页的分页器类。
19. ModelAdmin.prepopulated_fields:设置prepopulated_fields为字典，将字段名称映射到应预填充的字段.
20. ModelAdmin.preserve_filters:默认情况下，在创建，编辑或删除对象之后，已应用的过滤器将保留在列表视图上。您可以通过将此属性设置为清除过滤器False。
21. ModelAdmin.radio_fields:默认情况下，Django的管理员将选择框界面（）用于ForeignKey已choices设置或已设置的字段。如果中存在字段radio_fields，则Django将改用单选按钮界面。
22. ModelAdmin.autocomplete_fields:是您要更改为Select2自动完成输入的ForeignKey和/或 ManyToManyField字段的列表。
23. ModelAdmin.raw_id_fields:默认情况下，Django的管理员对字段使用选择框界面（）ForeignKey。有时，您不需要承担必须选择所有相关实例以显示在下拉列表中的开销。
24. ModelAdmin.readonly_fields:默认情况下，管理员将所有字段显示为可编辑。此选项中的任何字段（应为list或tuple）将按原样显示其数据，并且不可编辑；它们也被排除在 ModelForm用于创建和编辑之外。
25. ModelAdmin.save_as:设置save_as为在管理员更改表单上启用“另存为”功能。
26. ModelAdmin.save_as_continue:节省了新对象后的默认重定向是该对象的更改视图。如果设置了 save_as_continue=False，重定向将转到更改列表视图。
27. ModelAdmin.save_on_top:为在您的管理员更改表单顶部添加保存按钮。
28. ModelAdmin.search_fields:设置search_fields为在管理员更改列表页面上启用搜索框。应该将其设置为一个字段名称列表，只要有人在该文本框中提交搜索查询，就将对其进行搜索。
29. ModelAdmin.get_search_results:用来提供其他或替代的搜索行为。
30. ModelAdmin.show_full_result_count:以控制是否应在过滤的管理页面（例如）上显示对象的全部数量。
31. ModelAdmin.sortable_by:默认情况下，更改列表页面允许按中指定的所有模型字段（以及具有该admin_order_field属性的可调用对象） 进行排序list_display。
32. ModelAdmin.view_on_site:以控制是否显示“现场查看”链接。该链接应带您到一个URL，您可以在其中显示保存的对象。