field.html.twig 2.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. {#
  2. /**
  3. * @file
  4. * Theme override for a field.
  5. *
  6. * To override output, copy the "field.html.twig" from the templates directory
  7. * to your theme's directory and customize it, just like customizing other
  8. * Drupal templates such as page.html.twig or node.html.twig.
  9. *
  10. * Instead of overriding the theming for all fields, you can also just override
  11. * theming for a subset of fields using
  12. * @link themeable Theme hook suggestions. @endlink For example,
  13. * here are some theme hook suggestions that can be used for a field_foo field
  14. * on an article node type:
  15. * - field--node--field-foo--article.html.twig
  16. * - field--node--field-foo.html.twig
  17. * - field--node--article.html.twig
  18. * - field--field-foo.html.twig
  19. * - field--text-with-summary.html.twig
  20. * - field.html.twig
  21. *
  22. * Available variables:
  23. * - attributes: HTML attributes for the containing element.
  24. * - label_hidden: Whether to show the field label or not.
  25. * - title_attributes: HTML attributes for the title.
  26. * - label: The label for the field.
  27. * - multiple: TRUE if a field can contain multiple items.
  28. * - items: List of all the field items. Each item contains:
  29. * - attributes: List of HTML attributes for each item.
  30. * - content: The field item's content.
  31. * - entity_type: The entity type to which the field belongs.
  32. * - field_name: The name of the field.
  33. * - field_type: The type of the field.
  34. * - label_display: The display settings for the label.
  35. *
  36. *
  37. * @see template_preprocess_field()
  38. */
  39. #}
  40. {%
  41. set classes = [
  42. 'field',
  43. 'field--name-' ~ field_name|clean_class,
  44. 'field--type-' ~ field_type|clean_class,
  45. 'field--label-' ~ label_display,
  46. label_display == 'inline' ? 'clearfix',
  47. ]
  48. %}
  49. {%
  50. set title_classes = [
  51. 'field__label',
  52. label_display == 'visually_hidden' ? 'visually-hidden',
  53. ]
  54. %}
  55. {% if label_hidden %}
  56. {% if multiple %}
  57. <div{{ attributes.addClass(classes, 'field__items') }}>
  58. {% for item in items %}
  59. <div{{ item.attributes.addClass('field__item') }}>{{ item.content }}</div>
  60. {% endfor %}
  61. </div>
  62. {% else %}
  63. {% for item in items %}
  64. <div {{ attributes.addClass(classes, 'field__item') }}>{{ item.content }}</div>
  65. {% endfor %}
  66. {% endif %}
  67. {% else %}
  68. <div{{ attributes.addClass(classes) }}>
  69. <div{{ title_attributes.addClass(title_classes) }}>{{ label }}</div>
  70. {% if multiple %}
  71. <div class="field__items">
  72. {% endif %}
  73. {% for item in items %}
  74. <div{{ item.attributes.addClass('field__item') }}>{{ item.content }}</div>
  75. {% endfor %}
  76. {% if multiple %}
  77. </div>
  78. {% endif %}
  79. </div>
  80. {% endif %}