You are here

menu.html.twig in Drupal 10

Theme override to display a menu.

Available variables:

  • menu_name: The machine name of the menu.
  • items: A nested list of menu items. Each menu item contains:
    • attributes: HTML attributes for the menu item.
    • below: The menu item child items.
    • title: The menu link title.
    • url: The menu link url, instance of \Drupal\Core\Url
    • localized_options: Menu link localized options.
    • is_expanded: TRUE if the link has visible children within the current menu tree.
    • is_collapsed: TRUE if the link has children within the current menu tree that are not currently visible.
    • in_active_trail: TRUE if the link is in the active trail.

File

core/themes/claro/templates/classy/navigation/menu.html.twig
View source
  1. {#
  2. /**
  3. * @file
  4. * Theme override to display a menu.
  5. *
  6. * Available variables:
  7. * - menu_name: The machine name of the menu.
  8. * - items: A nested list of menu items. Each menu item contains:
  9. * - attributes: HTML attributes for the menu item.
  10. * - below: The menu item child items.
  11. * - title: The menu link title.
  12. * - url: The menu link url, instance of \Drupal\Core\Url
  13. * - localized_options: Menu link localized options.
  14. * - is_expanded: TRUE if the link has visible children within the current
  15. * menu tree.
  16. * - is_collapsed: TRUE if the link has children within the current menu tree
  17. * that are not currently visible.
  18. * - in_active_trail: TRUE if the link is in the active trail.
  19. */
  20. #}
  21. {% import _self as menus %}
  22. {#
  23. We call a macro which calls itself to render the full tree.
  24. @see https://twig.symfony.com/doc/3.x/tags/macro.html
  25. #}
  26. {{ menus.menu_links(items, attributes, 0) }}
  27. {% macro menu_links(items, attributes, menu_level) %}
  28. {% import _self as menus %}
  29. {% if items %}
  30. {% if menu_level == 0 %}
  31. <ul{{ attributes.addClass('menu') }}>
  32. {% else %}
  33. <ul class="menu">
  34. {% endif %}
  35. {% for item in items %}
  36. {%
  37. set classes = [
  38. 'menu-item',
  39. item.is_expanded ? 'menu-item--expanded',
  40. item.is_collapsed ? 'menu-item--collapsed',
  41. item.in_active_trail ? 'menu-item--active-trail',
  42. ]
  43. %}
  44. <li{{ item.attributes.addClass(classes) }}>
  45. {{ link(item.title, item.url) }}
  46. {% if item.below %}
  47. {{ menus.menu_links(item.below, attributes, menu_level + 1) }}
  48. {% endif %}
  49. </li>
  50. {% endfor %}
  51. </ul>
  52. {% endif %}
  53. {% endmacro %}