Link.action ViewHelper <f:link.action>
A ViewHelper for creating links to extbase actions. Tailored for extbase plugins, uses extbase Request and extbase UriBuilder.
Examples
link to the show-action of the current controller:
<f:link.action action="show">action link</f:link.action>
Copied!
Output:
<a href="index.php?id=123&tx_myextension_plugin[action]=show&tx_myextension_plugin[controller]=Standard&cHash=xyz">action link</a>
Copied!
Depending on the current page and your TypoScript configuration.
Source code
Go to the source code of this ViewHelper: Link\ActionViewHelper.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.action ViewHelper:
absolute
-
- Type
- bool
If set, the URI of the rendered link is absolute
accesskey
-
- Type
- string
Keyboard shortcut to access this element
action
-
- Type
- string
Target action
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.
additionalAttributes
-
- Type
- array
Additional tag attributes. They will be added directly to the resulting HTML tag.
additionalParams
-
- Type
- array
Additional query parameters that won't be prefixed like $arguments (overrule $arguments)
arguments
-
- Type
- array
Arguments for the controller action, associative array (do not use reserved keywords "action", "controller" or "format" if not referring to these internal variables specifically)
argumentsToBeExcludedFromQueryString
-
- Type
- array
Arguments to be removed from the URI. Only active if $addQueryString = TRUE
aria
-
- Type
- array
Additional aria-* attributes. They will each be added with a "aria-" prefix.
class
-
- Type
- string
CSS class(es) for this element
controller
-
- Type
- string
Target controller. If NULL current controllerName is used
data
-
- Type
- array
Additional data-* attributes. They will each be added with a "data-" prefix.
dir
-
- Type
- string
Text direction for this HTML element. Allowed strings: "ltr" (left to right), "rtl" (right to left)
extensionName
-
- Type
- string
Target Extension Name (without `tx_` prefix and no underscores). If NULL the current extension name is used
format
-
- Type
- string
The requested format, e.g. ".html
id
-
- Type
- string
Unique (in this file) identifier for this HTML element.
lang
-
- Type
- string
Language for this element. Use short names specified in RFC 1766
language
-
- Type
- string
link to a specific language - defaults to the current language, use a language ID or "current" to enforce a specific language
linkAccessRestrictedPages
-
- Type
- bool
If set, links pointing to access restricted pages will still link to the page even though the page cannot be accessed.
name
-
- Type
- string
Specifies the name of an anchor
noCache
-
- Type
- bool
Set this to disable caching for the target page. You should not need this.
onclick
-
- Type
- string
JavaScript evaluated for the onclick event
pageType
-
- Type
- int
Type of the target page. See typolink.parameter
pageUid
-
- Type
- int
Target page. See TypoLink destination
pluginName
-
- Type
- string
Target plugin. If empty, the current plugin name is used
rel
-
- Type
- string
Specifies the relationship between the current document and the linked document
rev
-
- Type
- string
Specifies the relationship between the linked document and the current document
section
-
- Type
- string
The anchor to be added to the URI
style
-
- Type
- string
Individual CSS styles for this element
tabindex
-
- Type
- integer
Specifies the tab order of this element
target
-
- Type
- string
Specifies where to open the linked document
title
-
- Type
- string
Tooltip text of element