class DialogRenderer
Same name in other branches
- 9 core/lib/Drupal/Core/Render/MainContent/DialogRenderer.php \Drupal\Core\Render\MainContent\DialogRenderer
- 8.9.x core/lib/Drupal/Core/Render/MainContent/DialogRenderer.php \Drupal\Core\Render\MainContent\DialogRenderer
- 10 core/lib/Drupal/Core/Render/MainContent/DialogRenderer.php \Drupal\Core\Render\MainContent\DialogRenderer
Default main content renderer for dialog requests.
Hierarchy
- class \Drupal\Core\Render\MainContent\DialogRenderer implements \Drupal\Core\Render\MainContent\MainContentRendererInterface
Expanded class hierarchy of DialogRenderer
File
-
core/
lib/ Drupal/ Core/ Render/ MainContent/ DialogRenderer.php, line 16
Namespace
Drupal\Core\Render\MainContentView source
class DialogRenderer implements MainContentRendererInterface {
/**
* The title resolver.
*
* @var \Drupal\Core\Controller\TitleResolverInterface
*/
protected $titleResolver;
/**
* The renderer.
*
* @var \Drupal\Core\Render\RendererInterface
*/
protected $renderer;
/**
* Constructs a new DialogRenderer.
*
* @param \Drupal\Core\Controller\TitleResolverInterface $title_resolver
* The title resolver.
* @param \Drupal\Core\Render\RendererInterface $renderer
* The renderer.
*/
public function __construct(TitleResolverInterface $title_resolver, RendererInterface $renderer) {
$this->titleResolver = $title_resolver;
$this->renderer = $renderer;
}
/**
* {@inheritdoc}
*/
public function renderResponse(array $main_content, Request $request, RouteMatchInterface $route_match) {
$response = new AjaxResponse();
// First render the main content, because it might provide a title.
$content = $this->renderer
->renderRoot($main_content);
// Attach the library necessary for using the OpenDialogCommand and set the
// attachments for this Ajax response.
$main_content['#attached']['library'][] = 'core/drupal.dialog.ajax';
$response->setAttachments($main_content['#attached']);
// Determine the title.
$title = $this->getTitleAsStringable($main_content, $request, $route_match);
// Determine the dialog options and the target for the OpenDialogCommand.
$options = $this->getDialogOptions($request);
$target = $this->determineTargetSelector($options, $route_match);
$response->addCommand(new OpenDialogCommand($target, $title, $content, $options));
return $response;
}
/**
* Determine the target selector for the OpenDialogCommand.
*
* @param array &$options
* The 'target' option, if set, is used, and then removed from $options.
* @param \Drupal\Core\Routing\RouteMatchInterface $route_match
* When no 'target' option is set in $options, $route_match is used instead
* to determine the target.
*
* @return string
* The target selector.
*/
protected function determineTargetSelector(array &$options, RouteMatchInterface $route_match) {
// Generate the target wrapper for the dialog.
if (isset($options['target'])) {
// If the target was nominated in the incoming options, use that.
$target = $options['target'];
// Ensure the target includes the #.
if (!str_starts_with($target, '#')) {
$target = '#' . $target;
}
// This shouldn't be passed on to jQuery.ui.dialog.
unset($options['target']);
}
else {
// Generate a target based on the route id.
$route_name = $route_match->getRouteName();
$target = '#' . Html::getUniqueId("drupal-dialog-{$route_name}");
}
return $target;
}
/**
* Returns the dialog options from request.
*
* @param \Symfony\Component\HttpFoundation\Request $request
* The HTTP request.
*
* @return array
* The dialog options used for OpenDialogCommand.
*/
protected function getDialogOptions(Request $request) : array {
if ($request->getMethod() === 'GET') {
return $request->query
->all('dialogOptions');
}
return $request->request
->all('dialogOptions');
}
/**
* Gets the title as a string or stringable object.
*
* Uses the title provided by the main content if any, otherwise gets it from
* the routing information.
*
* @param array $main_content
* The main content array.
* @param \Symfony\Component\HttpFoundation\Request $request
* The request.
* @param \Drupal\Core\Routing\RouteMatchInterface $route_match
* The route match.
*
* @return \Stringable|string|null
* The title as a string or stringable object.
*/
protected function getTitleAsStringable(array $main_content, Request $request, RouteMatchInterface $route_match) : \Stringable|string|null {
$title = $main_content['#title'] ?? $this->titleResolver
->getTitle($request, $route_match->getRouteObject());
if (is_array($title)) {
$title = $this->renderer
->renderInIsolation($title);
}
return $title;
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title | Overrides |
---|---|---|---|---|---|
DialogRenderer::$renderer | protected | property | The renderer. | 1 | |
DialogRenderer::$titleResolver | protected | property | The title resolver. | ||
DialogRenderer::determineTargetSelector | protected | function | Determine the target selector for the OpenDialogCommand. | ||
DialogRenderer::getDialogOptions | protected | function | Returns the dialog options from request. | ||
DialogRenderer::getTitleAsStringable | protected | function | Gets the title as a string or stringable object. | ||
DialogRenderer::renderResponse | public | function | Renders the main content render array into a response. | Overrides MainContentRendererInterface::renderResponse | 2 |
DialogRenderer::__construct | public | function | Constructs a new DialogRenderer. | 2 |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.