bootstrap_forms-8.x-1.x-dev/templates/form/form-element.html.twig

{#
/**
 * @file
 * Theme override 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 template_preprocess_form_element()
 */
#}
{% set classes = [
'js-form-item',
'form-item',
'js-form-type-' ~ type|clean_class,
'form-type-' ~ type|clean_class,
'js-form-item-' ~ name|clean_class,
'form-item-' ~ name|clean_class,
title_display not in ['after', 'before'] ? 'form-no-label',
disabled == 'disabled' ? 'form-disabled',
errors ? 'form-item--error',
] %}
{% set description_classes = [
'description',
description_display == 'invisible' ? 'visually-hidden',
] %}
{# Form Type Wrapper Opening tag #}
{% if form_type_wrapper %}
<div {{ form_type_attributes }}>
    {% endif %}

    {% if form_field_wrapper %}
    <div{{ attributes.addClass(classes) }}>
        {% endif %}

        {# Form Group Wrapper Opening tag #}
        {% if form_group_wrapper %}
        <div class="form-group">
            {% endif %}

            {% if label_display in ['before', 'invisible'] %}
                {{ label }}
            {% endif %}

            {# Form Element Wrapper Opening tag #}
            {% if form_element_wrapper %}
            <div {{ form_element_attributes }}>
                {% endif %}

                {% if form_element_row_wrapper %}
                <div class="row">
                    {% endif %}

                    {# Input group wrapper opening tag#}
                    {% if input_group_wrapper %}
                    <div class="input-group">
                        {% endif %}

                        {# Prefix/Input group addons #}
                        {% if prefix is not empty %}
                            <span {{ prefix_attributes }}>{{ prefix }}</span>
                        {% endif %}

                        {% if description_display == 'before' and description.content %}

                            <div{{ description.attributes }}>
                                {{ description.content }}
                            </div>
                        {% endif %}
                        {{ children }}

                        {# Suffix/Input group addons #}
                        {% if suffix is not empty %}
                            <span {{ suffix_attributes }}>{{ suffix }}</span>
                        {% endif %}

                        {% if label_display == 'after' %}
                            {{ label }}
                        {% endif %}

                        {# Input group wrapper opening tag#}
                        {% if input_group_wrapper %}
                    </div>
                    {% endif %}

                    {% if form_element_row_wrapper %}
                </div>
                {% endif %}


                {% if description_display in ['after', 'invisible'] and description.content %}
                    <div{{ description.attributes.addClass(description_classes) }}>
                        {{ description.content }}
                    </div>
                {% endif %}

                {# Form Element Wrapper Closing tag #}
                {% if form_element_wrapper %}
            </div>
            {% endif %}

            {# 'form group wrapper' closing tag #}
            {% if form_group_wrapper %}
        </div>
        {% endif %}

        {% if errors %}
            <div class="form-item--error-message">
                <strong>{{ errors }}</strong>
            </div>
        {% endif %}


        {% if form_field_wrapper %}
    </div>
    {% endif %}
    {# Form Type Wrapper Opening tag #}
    {% if form_type_wrapper %}
</div>
{% endif %}