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