Uri.resource ViewHelper <f:uri.resource>
ViewHelper for creating URIs to resources (assets).
This ViewHelper should be used to return public url to extension resource files for use in html output.
For images within FAL storages, or where graphical operations are performed, use <f: instead.
Go to the source code of this ViewHelper: Uri\ResourceViewHelper.php (GitHub).
Table of contents
Examples
Best practice with EXT: syntax
packages/my_extension/Resources/Private/Templates/Blog/Show.fluid.html
<link href="{f:uri.resource(path:'EXT:indexed_search/Resources/Public/Css/Stylesheet.css')}" rel="stylesheet" />
Copied!
Output
<link href="typo3/sysext/indexed_search/Resources/Public/Css/Stylesheet.css" rel="stylesheet" />
Copied!
Preferred syntax that works in both extbase and non-extbase context.
Defaults
packages/my_extension/Resources/Private/Templates/Blog/Show.fluid.html
<link href="{f:uri.resource(path:'Css/Stylesheet.css')}" rel="stylesheet" />
Copied!
Output
<link href="typo3conf/ext/example_extension/Resources/Public/Css/Stylesheet.css" rel="stylesheet" />
Copied!
Works only in extbase context since it uses the extbase request to find current extension, magically adds 'Resources/Public' to path.
With extension name
packages/my_extension/Resources/Private/Templates/Blog/Show.fluid.html
<link href="{f:uri.resource(path:'Css/Stylesheet.css', extensionName: 'AnotherExtension')}" rel="stylesheet" />
Copied!
Output
<link href="typo3conf/ext/another_extension/Resources/Public/Css/Stylesheet.css" rel="stylesheet" />
Copied!
Magically adds 'Resources/Public' to path.
Arguments of the <f:uri.resource> ViewHelper
absolute
-
- Type
- bool
- Default
- false
If set, an absolute URI is rendered
extensionName
-
- Type
- string
Target extension name. If not set, the current extension name will be used
path
-
- Type
- string
The path and filename of the resource (relative to Public resource directory of the extension).
resource
-
- Type
- object
The resource object given as argument or child
useCacheBusting
-
- Type
- bool
- Default
- true
If set, the URI is rendered with a cache buster