form-element.html.twig

Same filename in this branch
  1. 8.9.x core/profiles/demo_umami/themes/umami/templates/classy/form/form-element.html.twig
  2. 8.9.x core/themes/seven/templates/classy/form/form-element.html.twig
  3. 8.9.x core/themes/claro/templates/form-element.html.twig
  4. 8.9.x core/themes/bartik/templates/classy/form/form-element.html.twig
  5. 8.9.x core/themes/stable/templates/form/form-element.html.twig
  6. 8.9.x core/themes/classy/templates/form/form-element.html.twig
Same filename in other branches
  1. 9 core/profiles/demo_umami/themes/umami/templates/classy/form/form-element.html.twig
  2. 9 core/themes/stable9/templates/form/form-element.html.twig
  3. 9 core/themes/seven/templates/classy/form/form-element.html.twig
  4. 9 core/themes/claro/templates/form-element.html.twig
  5. 9 core/themes/bartik/templates/classy/form/form-element.html.twig
  6. 9 core/themes/stable/templates/form/form-element.html.twig
  7. 9 core/themes/starterkit_theme/templates/form/form-element.html.twig
  8. 9 core/themes/classy/templates/form/form-element.html.twig
  9. 9 core/modules/system/templates/form-element.html.twig
  10. 10 core/profiles/demo_umami/themes/umami/templates/classy/form/form-element.html.twig
  11. 10 core/themes/stable9/templates/form/form-element.html.twig
  12. 10 core/themes/claro/templates/form-element.html.twig
  13. 10 core/themes/starterkit_theme/templates/form/form-element.html.twig
  14. 10 core/modules/system/templates/form-element.html.twig
  15. 11.x core/profiles/demo_umami/themes/umami/templates/classy/form/form-element.html.twig
  16. 11.x core/themes/stable9/templates/form/form-element.html.twig
  17. 11.x core/themes/claro/templates/form-element.html.twig
  18. 11.x core/themes/starterkit_theme/templates/form/form-element.html.twig
  19. 11.x core/modules/system/templates/form-element.html.twig

Default theme implementation for a form element.

Available variables:

  • attributes: HTML attributes for the containing element.
  • errors: (optional) Any errors for this form element, may not be set.
  • prefix: (optional) The form element prefix, may not be set.
  • suffix: (optional) The form element suffix, may not be set.
  • required: The required marker, or empty if the associated form element is not required.
  • type: The type of the element.
  • name: The name of the element.
  • label: A rendered label element.
  • label_display: Label display setting. It can have these values:
    • before: The label is output before the element. This is the default. The label includes the #title and the required marker, if #required.
    • after: The label is output after the element. For example, this is used for radio and checkbox #type elements. If the #title is empty but the field is #required, the label will contain only the required marker.
    • invisible: Labels are critical for screen readers to enable them to properly navigate through forms but can be visually distracting. This property hides the label for everyone except screen readers.
    • attribute: Set the title attribute on the element to create a tooltip but output no label element. This is supported only for checkboxes and radios in \Drupal\Core\Render\Element\CompositeFormElementTrait::preRenderCompositeFormElement(). It is used where a visual label is not needed, such as a table of checkboxes where the row and column provide the context. The tooltip will include the title and required marker.
  • description: (optional) A list of description properties containing:
    • content: A description of the form element, may not be set.
    • attributes: (optional) A list of HTML attributes to apply to the description content wrapper. Will only be set when description is set.
  • description_display: Description display setting. It can have these values:
    • before: The description is output before the element.
    • after: The description is output after the element. This is the default value.
    • invisible: The description is output after the element, hidden visually but available to screen readers.
  • disabled: True if the element is disabled.
  • title_display: Title display setting.

See also

template_preprocess_form_element()

File

core/modules/system/templates/form-element.html.twig

View source
  1. {#
  2. /**
  3. * @file
  4. * Default theme implementation for a form element.
  5. *
  6. * Available variables:
  7. * - attributes: HTML attributes for the containing element.
  8. * - errors: (optional) Any errors for this form element, may not be set.
  9. * - prefix: (optional) The form element prefix, may not be set.
  10. * - suffix: (optional) The form element suffix, may not be set.
  11. * - required: The required marker, or empty if the associated form element is
  12. * not required.
  13. * - type: The type of the element.
  14. * - name: The name of the element.
  15. * - label: A rendered label element.
  16. * - label_display: Label display setting. It can have these values:
  17. * - before: The label is output before the element. This is the default.
  18. * The label includes the #title and the required marker, if #required.
  19. * - after: The label is output after the element. For example, this is used
  20. * for radio and checkbox #type elements. If the #title is empty but the
  21. * field is #required, the label will contain only the required marker.
  22. * - invisible: Labels are critical for screen readers to enable them to
  23. * properly navigate through forms but can be visually distracting. This
  24. * property hides the label for everyone except screen readers.
  25. * - attribute: Set the title attribute on the element to create a tooltip but
  26. * output no label element. This is supported only for checkboxes and radios
  27. * in \Drupal\Core\Render\Element\CompositeFormElementTrait::preRenderCompositeFormElement().
  28. * It is used where a visual label is not needed, such as a table of
  29. * checkboxes where the row and column provide the context. The tooltip will
  30. * include the title and required marker.
  31. * - description: (optional) A list of description properties containing:
  32. * - content: A description of the form element, may not be set.
  33. * - attributes: (optional) A list of HTML attributes to apply to the
  34. * description content wrapper. Will only be set when description is set.
  35. * - description_display: Description display setting. It can have these values:
  36. * - before: The description is output before the element.
  37. * - after: The description is output after the element. This is the default
  38. * value.
  39. * - invisible: The description is output after the element, hidden visually
  40. * but available to screen readers.
  41. * - disabled: True if the element is disabled.
  42. * - title_display: Title display setting.
  43. *
  44. * @see template_preprocess_form_element()
  45. *
  46. * @ingroup themeable
  47. */
  48. #}
  49. {%
  50. set classes = [
  51. 'js-form-item',
  52. 'form-item',
  53. 'js-form-type-' ~ type|clean_class,
  54. 'form-item-' ~ name|clean_class,
  55. 'js-form-item-' ~ name|clean_class,
  56. title_display not in ['after', 'before'] ? 'form-no-label',
  57. disabled == 'disabled' ? 'form-disabled',
  58. errors ? 'form-item--error',
  59. ]
  60. %}
  61. {%
  62. set description_classes = [
  63. 'description',
  64. description_display == 'invisible' ? 'visually-hidden',
  65. ]
  66. %}
  67. <div{{ attributes.addClass(classes) }}>
  68. {% if label_display in ['before', 'invisible'] %}
  69. {{ label }}
  70. {% endif %}
  71. {% if prefix is not empty %}
  72. <span class="field-prefix">{{ prefix }}</span>
  73. {% endif %}
  74. {% if description_display == 'before' and description.content %}
  75. <div{{ description.attributes }}>
  76. {{ description.content }}
  77. </div>
  78. {% endif %}
  79. {{ children }}
  80. {% if suffix is not empty %}
  81. <span class="field-suffix">{{ suffix }}</span>
  82. {% endif %}
  83. {% if label_display == 'after' %}
  84. {{ label }}
  85. {% endif %}
  86. {% if errors %}
  87. <div class="form-item--error-message">
  88. {{ errors }}
  89. </div>
  90. {% endif %}
  91. {% if description_display in ['after', 'invisible'] and description.content %}
  92. <div{{ description.attributes.addClass(description_classes) }}>
  93. {{ description.content }}
  94. </div>
  95. {% endif %}
  96. </div>

Related topics


Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.