Same name and namespace in other branches

1. 9 core/lib/Drupal/Core/Menu/MenuLinkTree.php \Drupal\Core\Menu\MenuLinkTree::build()
2. 8.9.x core/lib/Drupal/Core/Menu/MenuLinkTree.php \Drupal\Core\Menu\MenuLinkTree::build()
3. 11.x core/lib/Drupal/Core/Menu/MenuLinkTree.php \Drupal\Core\Menu\MenuLinkTree::build()

Builds a renderable array from a menu tree.

The menu item's LI element is given one of the following classes:

• expanded: The menu item is showing its submenu.
• collapsed: The menu item has a submenu that is not shown.
• leaf: The menu item has no submenu.

Parameters

\Drupal\Core\Menu\MenuLinkTreeElement[] $tree: A data structure representing the tree, as returned from MenuLinkTreeInterface::load().

Return value

array A renderable array.

Overrides MenuLinkTreeInterface::build

2 calls to MenuLinkTree::build()

NavigationMenuLinkTree::build in core/modules/navigation/src/Menu/NavigationMenuLinkTree.php

Builds a renderable array from a menu tree.

ToolbarMenuLinkTree::build in core/modules/toolbar/src/Menu/ToolbarMenuLinkTree.php

Builds a renderable array from a menu tree.

2 methods override MenuLinkTree::build()

NavigationMenuLinkTree::build in core/modules/navigation/src/Menu/NavigationMenuLinkTree.php

Builds a renderable array from a menu tree.

ToolbarMenuLinkTree::build in core/modules/toolbar/src/Menu/ToolbarMenuLinkTree.php

Builds a renderable array from a menu tree.

File

core/lib/Drupal/Core/Menu/MenuLinkTree.php, line 162

Class

MenuLinkTree

Implements the loading, transforming and rendering of menu link trees.

Namespace

Drupal\Core\Menu

Code

public function build(array $tree) {
  $tree_access_cacheability = new CacheableMetadata();
  $tree_link_cacheability = new CacheableMetadata();
  $items = $this->buildItems($tree, $tree_access_cacheability, $tree_link_cacheability);
  $build = [];
  // Apply the tree-wide gathered access cacheability metadata and link
  // cacheability metadata to the render array. This ensures that the
  // rendered menu is varied by the cache contexts that the access results
  // and (dynamic) links depended upon, and invalidated by the cache tags
  // that may change the values of the access results and links.
  $tree_cacheability = $tree_access_cacheability->merge($tree_link_cacheability);
  $tree_cacheability->applyTo($build);
  if ($items) {
    // Make sure Drupal\Core\Render\Element::children() does not re-order the
    // links.
    $build['#sorted'] = TRUE;
    // Get the menu name from the last link.
    $item = end($items);
    $link = $item['original_link'];
    $menu_name = $link->getMenuName();
    // Add the theme wrapper for outer markup.
    // Allow menu-specific theme overrides.
    $build['#theme'] = 'menu__' . strtr($menu_name, '-', '_');
    $build['#menu_name'] = $menu_name;
    $build['#items'] = $items;
    // Set cache tag.
    $build['#cache']['tags'][] = 'config:system.menu.' . $menu_name;
  }
  return $build;
}

---