Wagtail教程：如何基于模型字段设置InlinePanel子项标签？

将Wagtail中InlinePanel的子项标签（默认显示为“Field 1”）设置为动态内容，基于FormField模型的字段值，例如显示为{FormField.field_type} - {FormField.label}，方便在右侧概览中区分不同子项。已知InlinePanel的label参数仅支持静态统一标签，无法实现动态效果，现有模型代码如下，求实现方案。

现有模型代码 #

FormField模型 #

class FormField(AbstractFormField):
    label = models.CharField(
        blank=True,
        verbose_name=_("label"),
        max_length=255,
        help_text=_("The label of the form field"),
    )
    field_type = models.CharField(
        verbose_name="field type",
        max_length=16,
        choices=(("section", "Section"),) + FORM_FIELD_CHOICES,
    )
    page = ParentalKey(
        'ContactPageBase',
        on_delete=models.CASCADE,
        related_name='form_fields',
    )

ContactPageBase模型 #

class ContactPageBase(WagtailCaptchaEmailForm, BasePage):
    ...
    content_panels = AbstractEmailForm.content_panels + [
        FieldPanel('contact_intro'),
        InlinePanel('form_fields', heading=_('Form fields'), label=_("Field")),
        FieldPanel('thank_you_text')
    ]

Wagtail支持通过子模型的get_admin_display_title()方法自定义InlinePanel子项的显示标签，具体操作如下：

• 修改FormField模型
  在FormField类中添加get_admin_display_title()方法，该方法返回拼接后的动态标签内容：

  class FormField(AbstractFormField):
      # 原有字段代码保持不变...
      
      def get_admin_display_title(self):
          # 获取field_type选项对应的友好名称，若匹配失败则用原始值
          field_type_label = dict(self._meta.get_field('field_type').choices).get(self.field_type, self.field_type)
          # 处理label为空的情况，避免显示空白
          if self.label:
              return f"{field_type_label} - {self.label}"
          return f"{field_type_label} (未设置标签)"
  

• 无需调整InlinePanel配置
  无需修改ContactPageBase中的InlinePanel参数，Wagtail会自动调用get_admin_display_title()生成子项标签，覆盖默认的“Field N”格式。

• 效果说明
  当添加或编辑FormField子项时，右侧概览中的标签会自动更新为：

  • 若label已填写：[字段类型友好名称] - [标签内容]
  • 若label为空：[字段类型友好名称] (未设置标签)
    这样能清晰区分不同的表单字段。

内容的提问来源于stack exchange，提问作者toza-mimoza