class AjaxRenderer in Zircon Profile 8

Default main content renderer for Ajax requests.

Hierarchy

• class \Drupal\Core\Render\MainContent\AjaxRenderer implements MainContentRendererInterface

1 file declares its use of AjaxRenderer

AjaxRendererTest.php in core/tests/Drupal/Tests/Core/Controller/AjaxRendererTest.php

Contains \Drupal\Tests\Core\Controller\AjaxRendererTest.

1 string reference to 'AjaxRenderer'

core.services.yml in core/core.services.yml

core/core.services.yml

1 service uses AjaxRenderer

main_content_renderer.ajax in core/core.services.yml

Drupal\Core\Render\MainContent\AjaxRenderer

File

core/lib/Drupal/Core/Render/MainContent/AjaxRenderer.php, line 21

Contains \Drupal\Core\Render\MainContent\AjaxRenderer.

Namespace

Drupal\Core\Render\MainContent

class AjaxRenderer implements MainContentRendererInterface {

  /**
   * The controller resolver.
   *
   * @var \Drupal\Core\Controller\ControllerResolverInterface
   */
  protected $controllerResolver;

  /**
   * The element info manager.
   *
   * @var \Drupal\Core\Render\ElementInfoManagerInterface
   */
  protected $elementInfoManager;

  /**
   * Constructs a new AjaxRenderer instance.
   *
   * @param \Drupal\Core\Render\ElementInfoManagerInterface $element_info_manager
   *   The element info manager.
   */
  public function __construct(ElementInfoManagerInterface $element_info_manager) {
    $this->elementInfoManager = $element_info_manager;
  }

  /**
   * {@inheritdoc}
   */
  public function renderResponse(array $main_content, Request $request, RouteMatchInterface $route_match) {
    $response = new AjaxResponse();
    if (isset($main_content['#type']) && $main_content['#type'] == 'ajax') {

      // Complex Ajax callbacks can return a result that contains an error
      // message or a specific set of commands to send to the browser.
      $main_content += $this->elementInfoManager
        ->getInfo('ajax');
      $error = $main_content['#error'];
      if (!empty($error)) {

        // Fall back to some default message otherwise use the specific one.
        if (!is_string($error)) {
          $error = 'An error occurred while handling the request: The server received invalid input.';
        }
        $response
          ->addCommand(new AlertCommand($error));
      }
    }
    $html = $this
      ->drupalRenderRoot($main_content);
    $response
      ->setAttachments($main_content['#attached']);

    // The selector for the insert command is NULL as the new content will
    // replace the element making the Ajax call. The default 'replaceWith'
    // behavior can be changed with #ajax['method'].
    $response
      ->addCommand(new InsertCommand(NULL, $html));
    $status_messages = array(
      '#type' => 'status_messages',
    );
    $output = $this
      ->drupalRenderRoot($status_messages);
    if (!empty($output)) {
      $response
        ->addCommand(new PrependCommand(NULL, $output));
    }
    return $response;
  }

  /**
   * Wraps drupal_render_root().
   *
   * @todo Remove as part of https://www.drupal.org/node/2182149.
   */
  protected function drupalRenderRoot(&$elements) {
    return drupal_render_root($elements);
  }

}

Members

Name	Modifiers	Type	Description	Overrides
AjaxRenderer::$controllerResolver	protected	property	The controller resolver.
AjaxRenderer::$elementInfoManager	protected	property	The element info manager.
AjaxRenderer::drupalRenderRoot	protected	function	Wraps drupal_render_root().	1
AjaxRenderer::renderResponse	public	function	Renders the main content render array into a response. Overrides MainContentRendererInterface::renderResponse
AjaxRenderer::__construct	public	function	Constructs a new AjaxRenderer instance.