滚动
Drupal 主题化 第 5 课:字段主题化(field.tpl.php 模板)
在本课中,我们继续学习 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的模板。
复制并重命名模板后,请清除缓存,然后编辑新创建的模板文件。所有可用变量的说明可在模板文件的注释部分找到。