{#
/**
 * @file
 * 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.
 *   - has_link_title: FALSE, we don't show title on menu links for accessibility reasons
 */
#}

{% import "@rocketship-theme-starter-molecules/menus/menu/_menu--macros.twig" as menus %}

{# we might NOT want the link title to show up (e.g. in most navigations, for accessibility reasons). #}
{% set has_link_title = has_link_title|default(false) %}

{#
  We call a macro to render the full tree.
  @see http://twig.sensiolabs.org/doc/tags/macro.html
#}
{{ menus.menu_links(
  items,
  attributes,
  has_link_title,
  0,
  bem_menu_block,
  bem_menu_element,
  bem_menu_modifiers ? bem_menu_modifiers|merge([menu_name]) : [menu_name],
  bem_item_block,
  bem_item_element
) }}
