status-messages.html.twig

{#
/**
 * @file
 * Theme override for status messages.
 *
 * Displays status, error, and warning messages, grouped by type.
 *
 * An invisible heading identifies the messages for assistive technology.
 * Sighted users see a colored box. See https://www.w3.org/TR/WCAG-TECHS/H69.html
 * for info.
 *
 * Each message block exposes an ARIA live region role so assistive technology
 * user agents announce it appropriately: "alert" for errors and warnings
 * (assertive) and "status" for other message types (polite). This matches the
 * role assignment used by Drupal.theme.message() for messages added by
 * JavaScript. The "contentinfo" landmark role is reserved for the page footer
 * and is intentionally not used here, which avoids duplicate landmark and
 * non-unique landmark accessibility violations.
 *
 * Available variables:
 * - message_list: List of messages to be displayed, grouped by type.
 * - status_headings: List of all status types.
 * - attributes: HTML attributes for the element, including:
 *   - class: HTML classes.
 * - title_ids: A list of unique ids keyed by message type.
 *
 * @see claro_preprocess_status_messages().
 */
#}
<div data-drupal-messages class="messages-list">
  <div class="messages-list__wrapper">
    {% for type, messages in message_list %}
      {%
        set classes = [
          'messages-list__item',
          'messages',
          'messages--' ~ type,
        ]
      %}
      {%
        set is_message_with_title = status_headings[type]
      %}
      {%
        set is_message_with_icon = type in ['error', 'status', 'warning']
      %}

      <div role="{{ type in ['error', 'warning'] ? 'alert' : 'status' }}" aria-labelledby="{{ title_ids[type] }}"{{ attributes.addClass(classes)|without('role', 'aria-label') }}>
        {% if is_message_with_title or is_message_with_icon %}
          <div class="messages__header">
            {% if is_message_with_title %}
              <h2 id="{{ title_ids[type] }}" class="messages__title">
                {{ status_headings[type] }}
              </h2>
            {% endif %}
          </div>
        {% endif %}
        <div class="messages__content">
          {% if messages|length > 1 %}
            <ul class="messages__list">
              {% for message in messages %}
                <li class="messages__item">{{ message }}</li>
              {% endfor %}
            </ul>
          {% else %}
            {{ messages|first }}
          {% endif %}
        </div>
      </div>
      {# Remove type specific classes. #}
      {% set attributes = attributes.removeClass(classes) %}
    {% endfor %}
  </div>
</div>