function ContextualLinks::preRenderLinks

Same name in other branches
  1. 8.9.x core/modules/contextual/src/Element/ContextualLinks.php \Drupal\contextual\Element\ContextualLinks::preRenderLinks()
  2. 10 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.
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 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.