list_display | 在列表页面显示的模型字段或方法的名称列表。可以是模型字段名、函数或属性。 |
list_filter | 在右侧栏中显示的过滤器,允许根据特定字段进行筛选。可以是字段名或关系字段。 |
search_fields | 在列表页面上方的搜索框中可以根据哪些字段进行搜索。支持对文本字段进行模糊匹配搜索。 |
ordering | 指定列表页面的默认排序方式,按照给定的字段顺序排序。可以是单个字段或元组形式。 |
list_per_page | 每页显示的对象数,默认为 100 条。 |
readonly_fields | 设置为只读的字段,在后台编辑时这些字段不能被修改。 |
fieldsets | 自定义表单的显示布局,允许将表单字段分组显示。每个分组可以有标题和说明。 |
filter_horizontal | 用于多对多关系的字段,启用左右添加和移除选择框,而不是默认的下拉框。 |
filter_vertical | 与 filter_horizontal 类似,但选择框为垂直布局。 |
exclude | 排除不想在表单中显示的字段。 |
inlines | 允许在同一页面中嵌入相关的子对象表单,通常用于关联的 ForeignKey 或 ManyToManyField。 |
actions | 自定义动作,可在对象列表页面批量操作。默认提供删除操作。 |
date_hierarchy | 在页面顶部添加基于日期的导航栏,允许根据日期快速筛选记录。常用于 DateField 或 DateTimeField。 |
save_on_top | 如果设置为 True,保存按钮将显示在页面顶部(除了底部外),便于长表单的保存操作。 |
prepopulated_fields | 允许根据某些字段自动填充其他字段,通常用于生成 slug。格式为字典,键是目标字段,值是依赖字段。 |
formfield_overrides | 用于覆盖模型字段的默认表单字段属性,比如更改字段的小部件。 |
radio_fields | 将外键或选项字段转换为单选按钮进行显示。格式为字典,键是字段名,值是显示类型(如 admin.VERTICAL 或 admin.HORIZONTAL)。 |
raw_id_fields | 在表单中显示外键字段时,使用原始 ID 输入框代替下拉框,适用于关联对象较多的情况。 |
view_on_site | 如果设置为 True 或 URL 名称,管理后台的对象页面将有一个链接指向该对象在前端站点上的详情页面。 |
save_as | 启用后,保存现有对象时可以保存为一个新对象,而不是覆盖原有对象。 |
list_editable | 允许在列表页面中直接编辑的字段。 |
paginator_class | 指定自定义分页器类,默认为 admin.ModelAdmin.paginator。 |
show_full_result_count | 是否显示完整的对象计数。默认值是 True,可以关闭以提高性能。 |