Asset.css ViewHelper <f:asset.css>

ViewHelper to add CSS to the TYPO3 AssetCollector. Either a file or inline CSS can be added.

Examples

<f:asset.css identifier="identifier123" href="EXT:my_ext/Resources/Public/Css/foo.css" />
<f:asset.css identifier="identifier123">
   .foo { color: black; }
</f:asset.css>
Copied!

Details

In the AssetCollector, the "identifier" attribute is used as a unique identifier. Thus, if assets are added multiple times using the same identifier, the asset will only be served once (the last added overrides previous assets).

Some available attributes are defaults but do not make sense for this ViewHelper. Relevant attributes specific for this ViewHelper are: as, crossorigin, disabled, href, hreflang, importance, integrity, media, referrerpolicy, sizes, type, nonce.

Using the "inline" argument, the file content of the referenced file is added as inline style.

Source code

Go to the source code of this ViewHelper: Asset\CssViewHelper.php (GitHub).

Arguments

The following arguments are available for the asset.css ViewHelper:

additionalAttributes

additionalAttributes
Type
array
Additional tag attributes. They will be added directly to the resulting HTML tag.

aria

aria
Type
array
Additional aria-* attributes. They will each be added with a "aria-" prefix.

data

data
Type
array
Additional data-* attributes. They will each be added with a "data-" prefix.

disabled

disabled
Type
bool
Define whether or not the described stylesheet should be loaded and applied to the document.

identifier

identifier
Type
string
Required
1
Use this identifier within templates to only inject your CSS once, even though it is added multiple times.

inline

inline
Type
bool
Default
false
Define whether or not the referenced file should be loaded as inline styles (Only to be used if 'href' is set).

priority

priority
Type
boolean
Default
false
Define whether the CSS should be included before other CSS. CSS will always be output in the <head> tag.

useNonce

useNonce
Type
bool
Default
false
Whether to use the global nonce value