class PageDisplayVariantSelectionEvent in Drupal 9
Same name and namespace in other branches
- 8 core/lib/Drupal/Core/Render/PageDisplayVariantSelectionEvent.php \Drupal\Core\Render\PageDisplayVariantSelectionEvent
- 10 core/lib/Drupal/Core/Render/PageDisplayVariantSelectionEvent.php \Drupal\Core\Render\PageDisplayVariantSelectionEvent
Event fired when rendering main content, to select a page display variant.
Subscribers of this event can call the following setters to pass additional information along to the selected variant:
Hierarchy
- class \Drupal\Component\EventDispatcher\Event extends \Symfony\Component\EventDispatcher\Event
- class \Drupal\Core\Render\PageDisplayVariantSelectionEvent implements RefinableCacheableDependencyInterface uses RefinableCacheableDependencyTrait
Expanded class hierarchy of PageDisplayVariantSelectionEvent
See also
\Drupal\Core\Render\RenderEvents::SELECT_PAGE_DISPLAY_VARIANT
\Drupal\Core\Render\MainContent\HtmlRenderer
3 files declare their use of PageDisplayVariantSelectionEvent
- BlockPageDisplayVariantSubscriber.php in core/
modules/ block/ src/ EventSubscriber/ BlockPageDisplayVariantSubscriber.php - HtmlRenderer.php in core/
lib/ Drupal/ Core/ Render/ MainContent/ HtmlRenderer.php - TestPageDisplayVariantSubscriber.php in core/
modules/ system/ tests/ modules/ display_variant_test/ src/ EventSubscriber/ TestPageDisplayVariantSubscriber.php
File
- core/
lib/ Drupal/ Core/ Render/ PageDisplayVariantSelectionEvent.php, line 22
Namespace
Drupal\Core\RenderView source
class PageDisplayVariantSelectionEvent extends Event implements RefinableCacheableDependencyInterface {
use RefinableCacheableDependencyTrait;
/**
* The selected page display variant plugin ID.
*
* @var string
*/
protected $pluginId;
/**
* The configuration for the selected page display variant.
*
* @var array
*/
protected $pluginConfiguration = [];
/**
* The current route match.
*
* @var \Drupal\Core\Routing\RouteMatchInterface
*/
protected $routeMatch;
/**
* An array of collected contexts to pass to the page display variant.
*
* @var \Drupal\Component\Plugin\Context\ContextInterface[]
*/
protected $contexts = [];
/**
* Constructs the page display variant plugin selection event.
*
* @param string $plugin_id
* The ID of the page display variant plugin to use by default.
* @param \Drupal\Core\Routing\RouteMatchInterface $route_match
* The current route match, for context.
*/
public function __construct($plugin_id, RouteMatchInterface $route_match) {
$this->pluginId = $plugin_id;
$this->routeMatch = $route_match;
}
/**
* The selected page display variant plugin ID.
*
* @param string $plugin_id
* The ID of the page display variant plugin to use.
*
* @return $this
*/
public function setPluginId($plugin_id) {
$this->pluginId = $plugin_id;
return $this;
}
/**
* The selected page display variant plugin ID.
*
* @return string
*/
public function getPluginId() {
return $this->pluginId;
}
/**
* Set the configuration for the selected page display variant.
*
* @param array $configuration
* The configuration for the selected page display variant.
*
* @return $this
*/
public function setPluginConfiguration(array $configuration) {
$this->pluginConfiguration = $configuration;
return $this;
}
/**
* Get the configuration for the selected page display variant.
*
* @return array
*/
public function getPluginConfiguration() {
return $this->pluginConfiguration;
}
/**
* Gets the current route match.
*
* @return \Drupal\Core\Routing\RouteMatchInterface
* The current route match, for context.
*/
public function getRouteMatch() {
return $this->routeMatch;
}
/**
* Gets the contexts that were set during event dispatch.
*
* @return \Drupal\Component\Plugin\Context\ContextInterface[]
* An array of set contexts, keyed by context name.
*/
public function getContexts() {
return $this->contexts;
}
/**
* Sets the contexts to be passed to the page display variant.
*
* @param \Drupal\Component\Plugin\Context\ContextInterface[] $contexts
* An array of contexts, keyed by context name.
*
* @return $this
*/
public function setContexts(array $contexts) {
$this->contexts = $contexts;
return $this;
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
CacheableDependencyTrait:: |
protected | property | Cache contexts. | |
CacheableDependencyTrait:: |
protected | property | Cache max-age. | |
CacheableDependencyTrait:: |
protected | property | Cache tags. | |
CacheableDependencyTrait:: |
public | function | 4 | |
CacheableDependencyTrait:: |
public | function | 4 | |
CacheableDependencyTrait:: |
public | function | 4 | |
CacheableDependencyTrait:: |
protected | function | Sets cacheability; useful for value object constructors. | |
PageDisplayVariantSelectionEvent:: |
protected | property | An array of collected contexts to pass to the page display variant. | |
PageDisplayVariantSelectionEvent:: |
protected | property | The configuration for the selected page display variant. | |
PageDisplayVariantSelectionEvent:: |
protected | property | The selected page display variant plugin ID. | |
PageDisplayVariantSelectionEvent:: |
protected | property | The current route match. | |
PageDisplayVariantSelectionEvent:: |
public | function | Gets the contexts that were set during event dispatch. | |
PageDisplayVariantSelectionEvent:: |
public | function | Get the configuration for the selected page display variant. | |
PageDisplayVariantSelectionEvent:: |
public | function | The selected page display variant plugin ID. | |
PageDisplayVariantSelectionEvent:: |
public | function | Gets the current route match. | |
PageDisplayVariantSelectionEvent:: |
public | function | Sets the contexts to be passed to the page display variant. | |
PageDisplayVariantSelectionEvent:: |
public | function | Set the configuration for the selected page display variant. | |
PageDisplayVariantSelectionEvent:: |
public | function | The selected page display variant plugin ID. | |
PageDisplayVariantSelectionEvent:: |
public | function | Constructs the page display variant plugin selection event. | |
RefinableCacheableDependencyTrait:: |
public | function | 1 | |
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function |