public static ContextualLinks::preRenderLinks(array $element)
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 = array();
$contextual_links_manager = static::contextualLinkManager();
foreach ($element['#contextual_links'] as $group => $args) {
$args += array(
'route_parameters' => array(),
'metadata' => array(),
);
$items += $contextual_links_manager->getContextualLinksArrayByGroup($group, $args['route_parameters'], $args['metadata']);
}
// Transform contextual links into parameters suitable for links.html.twig.
$links = array();
foreach ($items as $class => $item) {
$class = Html::getClass($class);
$links[$class] = array(
'title' => $item['title'],
'url' => Url::fromRoute(isset($item['route_name']) ? $item['route_name'] : '', isset($item['route_parameters']) ? $item['route_parameters'] : []),
);
}
$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;
}
Please login to continue.