class CssCollectionRenderer
Same name in other branches
- 9 core/lib/Drupal/Core/Asset/CssCollectionRenderer.php \Drupal\Core\Asset\CssCollectionRenderer
- 8.9.x core/lib/Drupal/Core/Asset/CssCollectionRenderer.php \Drupal\Core\Asset\CssCollectionRenderer
- 10 core/lib/Drupal/Core/Asset/CssCollectionRenderer.php \Drupal\Core\Asset\CssCollectionRenderer
Renders CSS assets.
Hierarchy
- class \Drupal\Core\Asset\CssCollectionRenderer implements \Drupal\Core\Asset\AssetCollectionRendererInterface
Expanded class hierarchy of CssCollectionRenderer
1 file declares its use of CssCollectionRenderer
- CssCollectionRendererUnitTest.php in core/
tests/ Drupal/ Tests/ Core/ Asset/ CssCollectionRendererUnitTest.php
File
-
core/
lib/ Drupal/ Core/ Asset/ CssCollectionRenderer.php, line 10
Namespace
Drupal\Core\AssetView source
class CssCollectionRenderer implements AssetCollectionRendererInterface {
/**
* Constructs a CssCollectionRenderer.
*
* @param \Drupal\Core\Asset\AssetQueryStringInterface $assetQueryString
* The asset query string.
* @param \Drupal\Core\File\FileUrlGeneratorInterface $fileUrlGenerator
* The file URL generator.
*/
public function __construct(AssetQueryStringInterface $assetQueryString, FileUrlGeneratorInterface $fileUrlGenerator) {
}
/**
* {@inheritdoc}
*/
public function render(array $css_assets) {
$elements = [];
// A dummy query-string is added to filenames, to gain control over
// browser-caching. The string changes on every update or full cache
// flush, forcing browsers to load a new copy of the files, as the
// URL changed.
$query_string = $this->assetQueryString
->get();
// Defaults for LINK and STYLE elements.
$link_element_defaults = [
'#type' => 'html_tag',
'#tag' => 'link',
'#attributes' => [
'rel' => 'stylesheet',
],
];
foreach ($css_assets as $css_asset) {
$element = $link_element_defaults;
$element['#attributes']['media'] = $css_asset['media'];
switch ($css_asset['type']) {
// For file items, output a LINK tag for file CSS assets.
case 'file':
$element['#attributes']['href'] = $this->fileUrlGenerator
->generateString($css_asset['data']);
// Only add the cache-busting query string if this isn't an aggregate
// file.
if (!isset($css_asset['preprocessed'])) {
$query_string_separator = str_contains($css_asset['data'], '?') ? '&' : '?';
$element['#attributes']['href'] .= $query_string_separator . $query_string;
}
break;
case 'external':
$element['#attributes']['href'] = $css_asset['data'];
break;
default:
throw new \Exception('Invalid CSS asset type.');
}
// Merge any additional attributes.
if (!empty($css_asset['attributes'])) {
$element['#attributes'] += $css_asset['attributes'];
}
$elements[] = $element;
}
return $elements;
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|
CssCollectionRenderer::render | public | function | Renders an asset collection. | Overrides AssetCollectionRendererInterface::render |
CssCollectionRenderer::__construct | public | function | Constructs a CssCollectionRenderer. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.