logo

额外区块类型 (EBT) - 全新的布局构建器体验❗

额外区块类型 (EBT) - 样式化、可定制的区块类型:幻灯片、标签页、卡片、手风琴等更多类型。内置背景、DOM Box、JavaScript 插件的设置。立即体验布局构建的未来。

演示 EBT 模块 下载 EBT 模块

❗额外段落类型 (EPT) - 全新的 Paragraphs 体验

额外段落类型 (EPT) - 类似的基于 Paragraph 的模块集合。

演示 EPT 模块 滚动

滚动

Drupal 主题化 第 5 课:字段主题化(field.tpl.php 模板)

14/10/2025, by Ivan

在本课中,我们继续学习 Drupal 的主题化,这次我们将对字段(Field)进行主题化。完成本课后,我们将进一步学习如何对 Views 的输出进行主题化。

要对字段进行主题化,需要将文件 modules/field/theme/field.tpl.php 复制到主题的 templates 文件夹中,并根据以下命名规则重命名:

  • field--FIELD_TYPE.tpl.php — 模板将应用于所有指定类型(FIELD_TYPE)的字段。例如,要对所有 Image 类型的字段进行主题化,请创建名为 field--image.tpl.php 的模板。

  • field--FIELD_NAME.tpl.php — 模板将仅应用于指定名称(FIELD_NAME)的字段。例如,要对名为 field_images 的字段进行主题化,请创建名为 field--field_images.tpl.php 的模板。

  • field--BUNDLE.tpl.php — 模板将应用于指定内容类型(BUNDLE)中的所有字段。例如,要对内容类型 page 中的所有字段进行主题化,请创建名为 field--page.tpl.php 的模板。

  • field--FIELD_NAME--BUNDLE.tpl.php — 模板将仅应用于某一特定内容类型(BUNDLE)中的指定字段(FIELD_NAME)。例如,要对内容类型 page 中的 field_images 字段进行主题化,请创建名为 field--field_images--page.tpl.php 的模板。

复制并重命名模板后,请清除缓存,然后编辑新创建的模板文件。所有可用变量的说明可在模板文件的注释部分找到。