function RenderContext::update

Updates the current frame of the stack.

Parameters

array &$element: The element of the render array that has just been rendered. The stack frame for this element will be updated with the bubbleable rendering metadata of this element.

File

core/lib/Drupal/Core/Render/RenderContext.php, line 24

Class

RenderContext

The render context: a stack containing bubbleable rendering metadata.

Namespace

Code

public function update(&$element) {
    // The latest frame represents the bubbleable metadata for the subtree.
    $frame = $this->pop();
    // Update the frame, but also update the current element, to ensure it
    // contains up-to-date information in case it gets render cached.
    $updated_frame = BubbleableMetadata::createFromRenderArray($element)->merge($frame);
    $updated_frame->applyTo($element);
    $this->push($updated_frame);
}