navigation-menu.html.twig

{% import _self as menus %}
<div class="admin-toolbar__item">
  <h4 class="visually-hidden focusable">{{ title }}</h4>
  <ul class="toolbar-block__list">
    {{ 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.icon,
            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.icon,
            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>
            {{ icon('navigation', 'chevron', { class: 'toolbar-menu__chevron', size: 16 }) }}
          </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 %}
5 theme calls to navigation-menu.html.twig
NavigationLinkBlock::build in core/modules/navigation/src/Plugin/Block/NavigationLinkBlock.php
Builds and returns the renderable array for this block plugin.
NavigationShortcutsBlock::build in core/modules/navigation/src/Plugin/Block/NavigationShortcutsBlock.php
Builds and returns the renderable array for this block plugin.
NavigationTestBlock::build in core/modules/navigation/tests/navigation_test_block/src/Plugin/Block/NavigationTestBlock.php
Builds and returns the renderable array for this block plugin.
ShortcutLazyBuilder::lazyLinks in core/modules/navigation/src/ShortcutLazyBuilder.php
The #lazy_builder callback; builds shortcut navigation links.
WorkspacesLazyBuilder::renderNavigationLinks in core/modules/navigation/src/WorkspacesLazyBuilder.php
Lazy builder callback for rendering navigation links.

File

View on git.drupalcode.org

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

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

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

  3.   <h4 class="visually-hidden focusable">{{ title }}</h4>

  4.   <ul class="toolbar-block__list">

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

  6.   </ul>

  7. </div>

  8. 

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

  10.   {% for item in items %}

  11. 

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

  13. 

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

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

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

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

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

  19.       {% endif %}

  20.     {% endif %}

  21. 

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

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

  24.     {% else %}

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

  26.     {% endif %}

  27. 

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

  29.     {% if menu_level == 0 %}

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

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

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

  33.             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'),

  34.             icon: item.icon,

  35.             html_tag: item_link_tag,

  36.             text: item.title,

  37.             modifiers: [

  38.               'collapsible',

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

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

  41.           } only %}

  42.         </li>

  43.       {% else %}

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

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

  46.             action: 'Extend'|t,

  47.             attributes: create_attribute({

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

  49.               'aria-controls': item_id,

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

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

  52.             }),

  53.             icon: item.icon,

  54.             text: item.title,

  55.             modifiers: [

  56.               'expand--side',

  57.               'collapsible',

  58.             ],

  59.             extra_classes: [

  60.               'toolbar-popover__control',

  61.             ],

  62.           } only %}

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

  64.             {% if item.url %}

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

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

  67.                 html_tag: item_link_tag,

  68.                 text: item.title,

  69.                 modifiers: [

  70.                   'large',

  71.                   'dark',

  72.                 ],

  73.                 extra_classes: [

  74.                   'toolbar-popover__header',

  75.                 ],

  76.               } only %}

  77.             {% else %}

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

  79.                 attributes: create_attribute(),

  80.                 modifiers: [

  81.                   'large',

  82.                   'dark',

  83.                   'non-interactive',

  84.                 ],

  85.                 extra_classes: [

  86.                   'toolbar-popover__header',

  87.                 ],

  88.                 html_tag: 'span',

  89.                 text: item.title,

  90.               } only %}

  91.             {% endif %}

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

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

  94.             </ul>

  95.           </div>

  96.         </li>

  97.       {% endif %}

  98. 

  99.     {% elseif menu_level == 1 %}

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

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

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

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

  104.             text: item.title,

  105.             html_tag: item_link_tag,

  106.             extra_classes: [

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

  108.             ],

  109.           } only %}

  110.         {% else %}

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

  112.             attributes: create_attribute({

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

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

  115.             }),

  116.             text: item.title,

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

  118.           } only %}

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

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

  121.           </ul>

  122.         {% endif %}

  123.       </li>

  124.     {% else %}

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

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

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

  128.             'class': [

  129.               'toolbar-menu__link',

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

  131.             ],

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

  133.           }) }}

  134.         {% else %}

  135.           <button

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

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

  138.             aria-expanded="false"

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

  140.           >

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

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

  143.             {{ icon('navigation', 'chevron', { class: 'toolbar-menu__chevron', size: 16 }) }}

  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.