Drupal テーミング レッスン 5 フィールドのテーミング。Field.tpl.php テンプレート

このレッスンでは、Drupal のテーミングを続けます。今回はフィールドをテーミングします。このレッスンの後は、Views 出力のテーミングに進みます。

フィールドをテーミングするには、modules/field/theme/field.tpl.php ファイルをテーマの templates フォルダーにコピーし、次のいずれかのパターンに従って名前を変更する必要があります:

• field--FIELD_TYPE.tpl.php — このテンプレートは、FIELD_TYPE 型のすべてのフィールドに適用されます。たとえば、すべての画像フィールドをテーミングするには、field--image.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 という名前のテンプレートを作成します。

テンプレートをコピーして名前を変更した後、キャッシュをクリアして新しいファイルを編集します。利用可能なすべての変数の説明は、テンプレートのコメントに含まれています。