function ContextualLinks::preRenderLinks

Same name and namespace in other branches
  1. 9 core/modules/contextual/src/Element/ContextualLinks.php \Drupal\contextual\Element\ContextualLinks::preRenderLinks()
  2. 8.9.x core/modules/contextual/src/Element/ContextualLinks.php \Drupal\contextual\Element\ContextualLinks::preRenderLinks()
  3. 11.x core/modules/contextual/src/Element/ContextualLinks.php \Drupal\contextual\Element\ContextualLinks::preRenderLinks()

Pre-render callback: Builds a renderable array for contextual links.

Parameters

array $element: A renderable array containing a #contextual_links property, which is a keyed array. Each key is the name of the group of contextual links to render (based on the 'group' key in the *.links.contextual.yml files for all enabled modules). The value contains an associative array containing the following keys:

  • route_parameters: The route parameters passed to the URL generator.
  • metadata: Any additional data needed in order to alter the link.
[
  '#contextual_links' => [
    'block' => [
      'route_parameters' => [
        'block' => 'system.menu-tools',
      ],
    ],
    'menu' => [
      'route_parameters' => [
        'menu' => 'tools',
      ],
    ],
  ],
];

Return value

array A renderable array representing contextual links.

File

core/modules/contextual/src/Element/ContextualLinks.php, line 62

Class

ContextualLinks
Provides a contextual_links element.

Namespace

Drupal\contextual\Element

Code

public static function preRenderLinks(array $element) {
  // Retrieve contextual menu links.
  $items = [];
  $contextual_links_manager = static::contextualLinkManager();
  foreach ($element['#contextual_links'] as $group => $args) {
    $args += [
      'route_parameters' => [],
      'metadata' => [],
    ];
    $items += $contextual_links_manager->getContextualLinksArrayByGroup($group, $args['route_parameters'], $args['metadata']);
  }
  uasort($items, [
    SortArray::class,
    'sortByWeightElement',
  ]);
  // Transform contextual links into parameters suitable for links.html.twig.
  $links = [];
  foreach ($items as $class => $item) {
    $class = Html::getClass($class);
    $links[$class] = [
      'title' => $item['title'],
      'url' => Url::fromRoute($item['route_name'] ?? '', $item['route_parameters'] ?? [], $item['localized_options']),
    ];
  }
  $element['#links'] = $links;
  // Allow modules to alter the renderable contextual links element.
  static::moduleHandler()->alter('contextual_links_view', $element, $items);
  // If there are no links, tell \Drupal::service('renderer')->render() to
  // abort rendering.
  if (empty($element['#links'])) {
    $element['#printed'] = TRUE;
  }
  return $element;
}

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