class RenderContext in Drupal 8

The render context: a stack containing bubbleable rendering metadata.

A stack of \Drupal\Core\Render\BubbleableMetadata objects.

Hierarchy

• class \Drupal\Core\Render\RenderContext extends \Drupal\Core\Render\SplStack

See also

\Drupal\Core\Render\RendererInterface

\Drupal\Core\Render\Renderer

\Drupal\Core\Render\BubbleableMetadata

40 files declare their use of RenderContext

AssertContentTrait.php in core/tests/Drupal/KernelTests/AssertContentTrait.php

CacheTest.php in core/modules/views/tests/src/Kernel/Plugin/CacheTest.php

CommentFieldNameTest.php in core/modules/comment/tests/src/Kernel/Views/CommentFieldNameTest.php

EarlyRenderingControllerWrapperSubscriber.php in core/lib/Drupal/Core/EventSubscriber/EarlyRenderingControllerWrapperSubscriber.php

EntityResource.php in core/modules/jsonapi/src/Controller/EntityResource.php

... See full list

File

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

Namespace

Drupal\Core\Render

class RenderContext extends \SplStack {

  /**
   * Updates the current frame of the stack.
   *
   * @param 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.
   */
  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);
  }

  /**
   * Bubbles the stack.
   *
   * Whenever another level in the render array has been rendered, the stack
   * must be bubbled, to merge its rendering metadata with that of the parent
   * element.
   */
  public function bubble() {

    // If there's only one frame on the stack, then this is the root call, and
    // we can't bubble up further. ::renderRoot() will reset the stack, but we
    // must not reset it here to allow users of ::executeInRenderContext() to
    // access the stack directly.
    if ($this
      ->count() === 1) {
      return;
    }

    // Merge the current and the parent stack frame.
    $current = $this
      ->pop();
    $parent = $this
      ->pop();
    $this
      ->push($current
      ->merge($parent));
  }

}

Members

Name	Modifiers	Type	Description	Overrides
RenderContext::bubble	public	function	Bubbles the stack.
RenderContext::update	public	function	Updates the current frame of the stack.