navigation-menu.html.twig

{% import _self as menus %}
{% set menu_heading_id = 'menu--' ~ menu_name|clean_unique_id %}
<div class="admin-toolbar__item">
  <h4 id="{{ menu_heading_id }}" class="toolbar-block__title visually-hidden focusable">{{ title }}</h4>
  <ul class="toolbar-block__list" aria-labelledby="{{ menu_heading_id }}">
    {{ menus.menu_items(items, attributes, 0) }}
  </ul>
</div>

{% macro menu_items(items, attributes, menu_level) %}
  {% for item in items %}

    {% set item_link_tag = 'a' %}

    {% if item.url.isRouted %}
      {% if item.url.routeName == '<nolink>' %}
        {% set item_link_tag = constant('\\Drupal\\Core\\GeneratedNoLink::TAG') %}
      {% elseif item.url.routeName == '<button>' %}
        {% set item_link_tag = constant('\\Drupal\\Core\\GeneratedButton::TAG') %}
      {% endif %}
    {% endif %}

    {% if item.url.options.attributes is empty %}
      {% set item_link_attributes = create_attribute() %}
    {% else %}
      {% set item_link_attributes = create_attribute(item.url.options.attributes) %}
    {% endif %}

    {% set item_id = ('navigation-link--' ~ item.original_link.pluginId)|clean_unique_id %}
    {% if menu_level == 0 %}
      {% if item.below is empty %}
        <li id="{{ item_id }}" class="toolbar-block__list-item">
          {% include 'navigation:toolbar-button' with {
            attributes: item_link_attributes.setAttribute('href', item.url|render|default(null)).setAttribute('data-drupal-tooltip', item.title).setAttribute('data-drupal-tooltip-class', 'admin-toolbar__tooltip'),
            icon: item.class|clean_class,
            html_tag: item_link_tag,
            text: item.title,
            modifiers: [
              'collapsible',
              item_link_tag == 'span' ? 'non-interactive' : null
            ]|filter(v => v is not null),
          } only %}
        </li>
      {% else %}
        <li id="{{ item_id }}" class="toolbar-block__list-item toolbar-popover" data-toolbar-popover>
          {% include 'navigation:toolbar-button' with {
            action: 'Extend'|t,
            attributes: create_attribute({
              'aria-expanded': 'false',
              'aria-controls': item_id,
              'data-toolbar-popover-control': true,
              'data-has-safe-triangle': true,
            }),
            icon: item.class|clean_class,
            text: item.title,
            modifiers: [
              'expand--side',
              'collapsible',
            ],
            extra_classes: [
              'toolbar-popover__control',
            ],
          } only %}
          <div class="toolbar-popover__wrapper" data-toolbar-popover-wrapper inert>
            {% if item.url %}
              {% include 'navigation:toolbar-button' with {
                attributes: item_link_attributes.setAttribute('href', item.url|render),
                html_tag: item_link_tag,
                text: item.title,
                modifiers: [
                  'large',
                  'dark',
                ],
                extra_classes: [
                  'toolbar-popover__header',
                ],
              } only %}
            {% else %}
              {% include 'navigation:toolbar-button' with {
                attributes: create_attribute(),
                modifiers: [
                  'large',
                  'dark',
                  'non-interactive',
                ],
                extra_classes: [
                  'toolbar-popover__header',
                ],
                html_tag: 'span',
                text: item.title,
              } only %}
            {% endif %}
            <ul class="toolbar-menu toolbar-popover__menu">
              {{ menus.menu_items(item.below, attributes, 1) }}
            </ul>
          </div>
        </li>
      {% endif %}

    {% elseif menu_level == 1 %}
      <li class="toolbar-menu__item toolbar-menu__item--level-{{ menu_level }}">
        {% if item.below is empty  %}
          {% include 'navigation:toolbar-button' with {
            attributes: item_link_attributes.setAttribute('href', item.url|render|default(null)),
            text: item.title,
            html_tag: item_link_tag,
            extra_classes: [
              item_link_tag == 'span' ? 'toolbar-button--non-interactive'
            ],
          } only %}
        {% else %}
          {% include 'navigation:toolbar-button' with {
            attributes: create_attribute({
              'aria-expanded': 'false',
              'data-toolbar-menu-trigger': menu_level,
            }),
            text: item.title,
            modifiers: ['expand--down'],
          } only %}
          <ul class="toolbar-menu toolbar-menu--level-{{ menu_level + 1 }}" inert>
            {{ menus.menu_items(item.below, attributes, menu_level + 1) }}
          </ul>
        {% endif %}
      </li>
    {% else %}
      <li class="toolbar-menu__item toolbar-menu__item--level-{{ menu_level }}">
        {% if item.below is empty  %}
          {{ link(item.title, item.url, {
            'class': [
              'toolbar-menu__link',
              'toolbar-menu__link--' ~ menu_level,
            ],
            'data-index-text': item.title|first|lower
          }) }}
        {% else %}
          <button
            class="toolbar-menu__link toolbar-menu__link--{{ menu_level }}"
            data-toolbar-menu-trigger="{{ menu_level }}"
            aria-expanded="false"
            data-index-text="{{ item.title|first|lower }}"
          >
            <span data-toolbar-action class="toolbar-menu__link-action visually-hidden">{{ 'Extend'|t }}</span>
            <span class="toolbar-menu__link-title">{{ item.title }}</span>
          </button>
          <ul class="toolbar-menu toolbar-menu--level-{{ menu_level + 1 }}" inert>
            {{ menus.menu_items(item.below, attributes, menu_level + 1) }}
          </ul>
        {% endif %}
      </li>
    {% endif %}
  {% endfor %}
{% endmacro %}
1 theme call to navigation-menu.html.twig
ShortcutLazyBuilder::lazyLinks in core/modules/navigation/src/ShortcutLazyBuilder.php
The #lazy_builder callback; builds shortcut navigation links.

File

View on git.drupalcode.org

core/modules/navigation/templates/navigation-menu.html.twig

View source 
  1. {% import _self as menus %}

  2. {% set menu_heading_id = 'menu--' ~ menu_name|clean_unique_id %}

  3. <div class="admin-toolbar__item">

  4.   <h4 id="{{ menu_heading_id }}" class="toolbar-block__title visually-hidden focusable">{{ title }}</h4>

  5.   <ul class="toolbar-block__list" aria-labelledby="{{ menu_heading_id }}">

  6.     {{ menus.menu_items(items, attributes, 0) }}

  7.   </ul>

  8. </div>

  9. 

  10. {% macro menu_items(items, attributes, menu_level) %}

  11.   {% for item in items %}

  12. 

  13.     {% set item_link_tag = 'a' %}

  14. 

  15.     {% if item.url.isRouted %}

  16.       {% if item.url.routeName == '<nolink>' %}

  17.         {% set item_link_tag = constant('\\Drupal\\Core\\GeneratedNoLink::TAG') %}

  18.       {% elseif item.url.routeName == '<button>' %}

  19.         {% set item_link_tag = constant('\\Drupal\\Core\\GeneratedButton::TAG') %}

  20.       {% endif %}

  21.     {% endif %}

  22. 

  23.     {% if item.url.options.attributes is empty %}

  24.       {% set item_link_attributes = create_attribute() %}

  25.     {% else %}

  26.       {% set item_link_attributes = create_attribute(item.url.options.attributes) %}

  27.     {% endif %}

  28. 

  29.     {% set item_id = ('navigation-link--' ~ item.original_link.pluginId)|clean_unique_id %}

  30.     {% if menu_level == 0 %}

  31.       {% if item.below is empty %}

  32.         <li id="{{ item_id }}" class="toolbar-block__list-item">

  33.           {% include 'navigation:toolbar-button' with {

  34.             attributes: item_link_attributes.setAttribute('href', item.url|render|default(null)).setAttribute('data-drupal-tooltip', item.title).setAttribute('data-drupal-tooltip-class', 'admin-toolbar__tooltip'),

  35.             icon: item.class|clean_class,

  36.             html_tag: item_link_tag,

  37.             text: item.title,

  38.             modifiers: [

  39.               'collapsible',

  40.               item_link_tag == 'span' ? 'non-interactive' : null

  41.             ]|filter(v => v is not null),

  42.           } only %}

  43.         </li>

  44.       {% else %}

  45.         <li id="{{ item_id }}" class="toolbar-block__list-item toolbar-popover" data-toolbar-popover>

  46.           {% include 'navigation:toolbar-button' with {

  47.             action: 'Extend'|t,

  48.             attributes: create_attribute({

  49.               'aria-expanded': 'false',

  50.               'aria-controls': item_id,

  51.               'data-toolbar-popover-control': true,

  52.               'data-has-safe-triangle': true,

  53.             }),

  54.             icon: item.class|clean_class,

  55.             text: item.title,

  56.             modifiers: [

  57.               'expand--side',

  58.               'collapsible',

  59.             ],

  60.             extra_classes: [

  61.               'toolbar-popover__control',

  62.             ],

  63.           } only %}

  64.           <div class="toolbar-popover__wrapper" data-toolbar-popover-wrapper inert>

  65.             {% if item.url %}

  66.               {% include 'navigation:toolbar-button' with {

  67.                 attributes: item_link_attributes.setAttribute('href', item.url|render),

  68.                 html_tag: item_link_tag,

  69.                 text: item.title,

  70.                 modifiers: [

  71.                   'large',

  72.                   'dark',

  73.                 ],

  74.                 extra_classes: [

  75.                   'toolbar-popover__header',

  76.                 ],

  77.               } only %}

  78.             {% else %}

  79.               {% include 'navigation:toolbar-button' with {

  80.                 attributes: create_attribute(),

  81.                 modifiers: [

  82.                   'large',

  83.                   'dark',

  84.                   'non-interactive',

  85.                 ],

  86.                 extra_classes: [

  87.                   'toolbar-popover__header',

  88.                 ],

  89.                 html_tag: 'span',

  90.                 text: item.title,

  91.               } only %}

  92.             {% endif %}

  93.             <ul class="toolbar-menu toolbar-popover__menu">

  94.               {{ menus.menu_items(item.below, attributes, 1) }}

  95.             </ul>

  96.           </div>

  97.         </li>

  98.       {% endif %}

  99. 

  100.     {% elseif menu_level == 1 %}

  101.       <li class="toolbar-menu__item toolbar-menu__item--level-{{ menu_level }}">

  102.         {% if item.below is empty  %}

  103.           {% include 'navigation:toolbar-button' with {

  104.             attributes: item_link_attributes.setAttribute('href', item.url|render|default(null)),

  105.             text: item.title,

  106.             html_tag: item_link_tag,

  107.             extra_classes: [

  108.               item_link_tag == 'span' ? 'toolbar-button--non-interactive'

  109.             ],

  110.           } only %}

  111.         {% else %}

  112.           {% include 'navigation:toolbar-button' with {

  113.             attributes: create_attribute({

  114.               'aria-expanded': 'false',

  115.               'data-toolbar-menu-trigger': menu_level,

  116.             }),

  117.             text: item.title,

  118.             modifiers: ['expand--down'],

  119.           } only %}

  120.           <ul class="toolbar-menu toolbar-menu--level-{{ menu_level + 1 }}" inert>

  121.             {{ menus.menu_items(item.below, attributes, menu_level + 1) }}

  122.           </ul>

  123.         {% endif %}

  124.       </li>

  125.     {% else %}

  126.       <li class="toolbar-menu__item toolbar-menu__item--level-{{ menu_level }}">

  127.         {% if item.below is empty  %}

  128.           {{ link(item.title, item.url, {

  129.             'class': [

  130.               'toolbar-menu__link',

  131.               'toolbar-menu__link--' ~ menu_level,

  132.             ],

  133.             'data-index-text': item.title|first|lower

  134.           }) }}

  135.         {% else %}

  136.           <button

  137.             class="toolbar-menu__link toolbar-menu__link--{{ menu_level }}"

  138.             data-toolbar-menu-trigger="{{ menu_level }}"

  139.             aria-expanded="false"

  140.             data-index-text="{{ item.title|first|lower }}"

  141.           >

  142.             <span data-toolbar-action class="toolbar-menu__link-action visually-hidden">{{ 'Extend'|t }}</span>

  143.             <span class="toolbar-menu__link-title">{{ item.title }}</span>

  144.           </button>

  145.           <ul class="toolbar-menu toolbar-menu--level-{{ menu_level + 1 }}" inert>

  146.             {{ menus.menu_items(item.below, attributes, menu_level + 1) }}

  147.           </ul>

  148.         {% endif %}

  149.       </li>

  150.     {% endif %}

  151.   {% endfor %}

  152. {% endmacro %}

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