Python Django ModelAdmin.fields用法及代码示例

本文介绍 django.contrib.admin.ModelAdmin.fields 的用法。

声明

ModelAdmin.fields

使用fields 选项在“add” 和“change” 页面上的表单中进行简单的布局更改，例如仅显示可用字段的子集、修改它们的顺序或将它们分组到行中。例如，您可以为 django.contrib.flatpages.models.FlatPage 模型定义一个更简单的管理表单版本，如下所示：

class FlatPageAdmin(admin.ModelAdmin):
    fields = ('url', 'title', 'content')

在上面的示例中，只有字段 url 、 title 和 content 将在表单中按顺序显示。 fields 可以包含在 ModelAdmin.readonly_fields 中定义的值，以只读方式显示。

如需更复杂的布局需求，请参阅 fieldsets 选项。

fields 选项接受与 list_display 相同类型的值，但不接受可调用对象。只有在 readonly_fields 中列出的模型和模型管理方法的名称才会被使用。

要在同一行显示多个字段，请将这些字段包装在它们自己的元组中。在此示例中，url 和 title 字段将显示在同一行，而 content 字段将在它们下方单独显示：

class FlatPageAdmin(admin.ModelAdmin):
    fields = (('url', 'title'), 'content')

注意

此 fields 选项不应与 fieldsets 选项中的 fields 字典键相混淆，如下一节所述。

如果既不存在 fields 也不存在 fieldsets 选项，Django 将默认显示每个不是 AutoField 且具有 editable=True 的字段，在单个字段集中，其顺序与在模型。

相关用法

注：本文由纯净天空筛选整理自djangoproject.com大神的英文原创作品 django.contrib.admin.ModelAdmin.fields。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。