field.html.twig
Same filename in this branch
- 8.9.x core/themes/seven/templates/classy/field/field.html.twig
- 8.9.x core/themes/claro/templates/classy/field/field.html.twig
- 8.9.x core/themes/bartik/templates/classy/field/field.html.twig
- 8.9.x core/themes/stable/templates/field/field.html.twig
- 8.9.x core/themes/classy/templates/field/field.html.twig
- 8.9.x core/modules/system/templates/field.html.twig
Same filename in other branches
- 9 core/profiles/demo_umami/themes/umami/templates/classy/field/field.html.twig
- 9 core/themes/olivero/templates/field/field.html.twig
- 9 core/themes/stable9/templates/field/field.html.twig
- 9 core/themes/seven/templates/classy/field/field.html.twig
- 9 core/themes/claro/templates/classy/field/field.html.twig
- 9 core/themes/bartik/templates/classy/field/field.html.twig
- 9 core/themes/stable/templates/field/field.html.twig
- 9 core/themes/starterkit_theme/templates/field/field.html.twig
- 9 core/themes/classy/templates/field/field.html.twig
- 9 core/modules/system/templates/field.html.twig
- 10 core/profiles/demo_umami/themes/umami/templates/classy/field/field.html.twig
- 10 core/themes/olivero/templates/field/field.html.twig
- 10 core/themes/stable9/templates/field/field.html.twig
- 10 core/themes/claro/templates/classy/field/field.html.twig
- 10 core/themes/starterkit_theme/templates/field/field.html.twig
- 10 core/modules/system/templates/field.html.twig
- 11.x core/profiles/demo_umami/themes/umami/templates/classy/field/field.html.twig
- 11.x core/themes/olivero/templates/field/field.html.twig
- 11.x core/themes/stable9/templates/field/field.html.twig
- 11.x core/themes/claro/templates/classy/field/field.html.twig
- 11.x core/themes/starterkit_theme/templates/field/field.html.twig
- 11.x core/modules/system/templates/field.html.twig
Theme override for a field.
To override output, copy the "field.html.twig" from the templates directory to your theme's directory and customize it, just like customizing other Drupal templates such as page.html.twig or node.html.twig.
Instead of overriding the theming for all fields, you can also just override theming for a subset of fields using Theme hook suggestions. For example, here are some theme hook suggestions that can be used for a field_foo field on an article node type:
- field--node--field-foo--article.html.twig
- field--node--field-foo.html.twig
- field--node--article.html.twig
- field--field-foo.html.twig
- field--text-with-summary.html.twig
- field.html.twig
Available variables:
- attributes: HTML attributes for the containing element.
- label_hidden: Whether to show the field label or not.
- title_attributes: HTML attributes for the title.
- label: The label for the field.
- multiple: TRUE if a field can contain multiple items.
- items: List of all the field items. Each item contains:
- attributes: List of HTML attributes for each item.
- content: The field item's content.
- entity_type: The entity type to which the field belongs.
- field_name: The name of the field.
- field_type: The type of the field.
- label_display: The display settings for the label.
See also
1 theme call to field.html.twig
- FormatterBase::view in core/
lib/ Drupal/ Core/ Field/ FormatterBase.php - Builds a renderable array for a fully themed field.
File
-
core/
profiles/ demo_umami/ themes/ umami/ templates/ classy/ field/ field.html.twig
View source
- {#
- /**
- * @file
- * Theme override for a field.
- *
- * To override output, copy the "field.html.twig" from the templates directory
- * to your theme's directory and customize it, just like customizing other
- * Drupal templates such as page.html.twig or node.html.twig.
- *
- * Instead of overriding the theming for all fields, you can also just override
- * theming for a subset of fields using
- * @link themeable Theme hook suggestions. @endlink For example,
- * here are some theme hook suggestions that can be used for a field_foo field
- * on an article node type:
- * - field--node--field-foo--article.html.twig
- * - field--node--field-foo.html.twig
- * - field--node--article.html.twig
- * - field--field-foo.html.twig
- * - field--text-with-summary.html.twig
- * - field.html.twig
- *
- * Available variables:
- * - attributes: HTML attributes for the containing element.
- * - label_hidden: Whether to show the field label or not.
- * - title_attributes: HTML attributes for the title.
- * - label: The label for the field.
- * - multiple: TRUE if a field can contain multiple items.
- * - items: List of all the field items. Each item contains:
- * - attributes: List of HTML attributes for each item.
- * - content: The field item's content.
- * - entity_type: The entity type to which the field belongs.
- * - field_name: The name of the field.
- * - field_type: The type of the field.
- * - label_display: The display settings for the label.
- *
- *
- * @see template_preprocess_field()
- */
- #}
- {%
- set classes = [
- 'field',
- 'field--name-' ~ field_name|clean_class,
- 'field--type-' ~ field_type|clean_class,
- 'field--label-' ~ label_display,
- label_display == 'inline' ? 'clearfix',
- ]
- %}
- {%
- set title_classes = [
- 'field__label',
- label_display == 'visually_hidden' ? 'visually-hidden',
- ]
- %}
-
- {% if label_hidden %}
- {% if multiple %}
- <div{{ attributes.addClass(classes, 'field__items') }}>
- {% for item in items %}
- <div{{ item.attributes.addClass('field__item') }}>{{ item.content }}</div>
- {% endfor %}
- </div>
- {% else %}
- {% for item in items %}
- <div{{ attributes.addClass(classes, 'field__item') }}>{{ item.content }}</div>
- {% endfor %}
- {% endif %}
- {% else %}
- <div{{ attributes.addClass(classes) }}>
- <div{{ title_attributes.addClass(title_classes) }}>{{ label }}</div>
- {% if multiple %}
- <div class="field__items">
- {% endif %}
- {% for item in items %}
- <div{{ item.attributes.addClass('field__item') }}>{{ item.content }}</div>
- {% endfor %}
- {% if multiple %}
- </div>
- {% endif %}
- </div>
- {% endif %}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.