You are here

public static function ContextualLinks::preRenderLinks in Drupal 9

Same name and namespace in other branches
  1. 8 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.
array(
  '#contextual_links' => array(
    'block' => array(
      'route_parameters' => array(
        'block' => 'system.menu-tools',
      ),
    ),
    'menu' => array(
      'route_parameters' => array(
        'menu' => 'tools',
      ),
    ),
  ),
);

Return value

array A renderable array representing contextual links.

File

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

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']);
  }

  // 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(isset($item['route_name']) ? $item['route_name'] : '', isset($item['route_parameters']) ? $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_render() to abort rendering.
  if (empty($element['#links'])) {
    $element['#printed'] = TRUE;
  }
  return $element;
}