Wagtail中如何将GalleryBlock直接用作StrictContentPage字段优化后台显示？

你可以用Wagtail提供的BlockField来直接把GalleryBlock作为StrictContentPage的模型字段，完全替代之前仅含单个GalleryBlock的StreamField，解决后台嵌套显示的问题。

实现步骤： #

1. 导入BlockField
   从wagtail的fields模块中引入BlockField，它专门用来将Wagtail的Block类型作为模型字段使用。

2. 修改StrictContentPage模型
   把原来的StreamField替换为BlockField(GalleryBlock())，并在content_panels中添加对应的FieldPanel：

   from wagtail.models import Page
   from wagtail.fields import BlockField
   from yourapp.blocks import GalleryBlock  # 替换为你的GalleryBlock所在路径
   
   class StrictContentPage(Page):
       # 直接使用BlockField包装GalleryBlock
       gallery = BlockField(GalleryBlock())
   
       content_panels = Page.content_panels + [
           FieldPanel("gallery"),
       ]
   

3. 模板渲染调整
   原来渲染StreamField的方式是遍历流中的块，现在直接调用BlockField字段的render()方法即可：

   <!-- strict_content_page.html -->
   {% extends "base.html" %}
   
   {% block content %}
       <h1>{{ page.title }}</h1>
       {{ page.gallery.render }}
   {% endblock %}
   

   如果你的GalleryBlock需要额外上下文参数（比如当前页面对象），可以在render时传入：

   {{ page.gallery.render(page=page) }}
   

注意事项： #

• 确保你的GalleryBlock在Meta类中指定了正确的模板路径，这样render()方法才能找到对应的渲染模板：

  class GalleryBlock(StructBlock):
      # 你的块定义...
  
      class Meta:
          template = "blocks/gallery_block.html"
          icon = "image"
  

• 如果之前用StreamField存储了数据，切换到BlockField需要编写数据迁移脚本，将旧StreamField数组中的第一个元素提取出来，赋值给新的gallery字段（因为StreamField存的是JSON数组，而BlockField存的是单个JSON对象）。
• BlockField完全支持GalleryBlock的所有原有配置（比如autoadvance选项），后台编辑时会直接显示GalleryBlock的原生编辑界面，没有嵌套层级。

内容的提问来源于stack exchange，提问作者axoplasm