Link.page ViewHelper <f:link.page>
¶
A ViewHelper for creating links to TYPO3 pages.
Examples¶
Link to the current page¶
<f:link.page>page link</f:link.page>
Copied!
Output:
<a href="/page/path/name.html">page link</a>
Copied!
Depending on current page, routing and page path configuration.
Query parameters¶
<f:link.page pageUid="1" additionalParams="{foo: 'bar'}">page link</f:link.page>
Copied!
Output:
<a href="/page/path/name.html?foo=bar">page link</a>
Copied!
Depending on current page, routing and page path configuration.
Query parameters for extensions¶
<f:link.page pageUid="1" additionalParams="{extension_key: {foo: 'bar'}}">page link</f:link.page>
Copied!
Output:
<a href="/page/path/name.html?extension_key[foo]=bar">page link</a>
Copied!
Depending on current page, routing and page path configuration.
Source code
Go to the source code of this ViewHelper: Link\PageViewHelper.php (GitHub).
Arguments
Allows arbitrary arguments
This ViewHelper allows you to pass arbitrary arguments not defined below directly to the HTML tag created. This includes custom `data-` arguments.
The following arguments are available for the link.page ViewHelper:
-
additionalAttributes
¶ -
- Type
- array
Additional tag attributes. They will be added directly to the resulting HTML tag.
-
data
¶ -
- Type
- array
Additional data-* attributes. They will each be added with a "data-" prefix.
-
aria
¶ -
- Type
- array
Additional aria-* attributes. They will each be added with a "aria-" prefix.
-
pageUid
¶ -
- Type
- int
Target page. See TypoLink destination
-
pageType
¶ -
- Type
- int
Type of the target page. See typolink.parameter
-
noCache
¶ -
- Type
- bool
Set this to disable caching for the target page. You should not need this.
-
language
¶ -
- Type
- string
link to a specific language - defaults to the current language, use a language ID or "current" to enforce a specific language
-
section
¶ -
- Type
- string
The anchor to be added to the URI
-
linkAccessRestrictedPages
¶ -
- Type
- bool
If set, links pointing to access restricted pages will still link to the page even though the page cannot be accessed.
-
additionalParams
¶ -
- Type
- array
Additional query parameters that won't be prefixed like $arguments (overrule $arguments)
-
absolute
¶ -
- Type
- bool
If set, the URI of the rendered link is absolute
-
addQueryString
¶ -
- Type
- string
- Default
- false
If set, the current query parameters will be kept in the URL. If set to "untrusted", then ALL query parameters will be added. Be aware, that this might lead to problems when the generated link is cached.
-
argumentsToBeExcludedFromQueryString
¶ -
- Type
- array
Arguments to be removed from the URI. Only active if $addQueryString = true