SuperAPI AI 工具集

drupal-paragraphs

前端与建站

查看项目

更新于 10-15 21:37

技能介绍

Drupal Paragraphs 是 Drupal 中用于结构化内容的模块,本资料集中说明在自定义代码和主题中如何使用它。主要涵盖四个方面:从节点访问段落、程序化创建段落、修改段落表单,以及渲染段落。

访问段落:通过字段的 referencedEntities() 获取节点中引用的全部段落实体,可读取段落 bundle 和字段值;也可用 first()?->entity 取首个段落。

创建段落:使用 Paragraph::create() 传入 type 及各字段值创建并 save(),再通过节点的段落字段 appendItem() 附加 target_id 和 target_revision_id,最后保存节点。

修改表单:可使用 field_widget_single_element_paragraphs_form_alter 钩子,通过 $element['#paragraph'] 获取当前段落,按 bundle 判断并调整子表单元素,例如把某字段的 #access 设为 FALSE。

渲染:用 entityTypeManager 的 getViewBuilder('paragraph') 和 view() 生成渲染数组;在 Twig 中可直接输出 content.field_content,或遍历 content.field_content['#items'] 读取 item.entity.field_text.value。

常见模式:遍历 referencedEntities() 并对 $paragraph->bundle() 做 switch 分支,分别处理 text_block、image_block 等不同类型的段落。

限制:资料未提供安装、配置、版本要求、性能或兼容性说明,均暂未提供。