Attention
TYPO3 v11 has reached end-of-life as of October 31th 2024 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.
Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v11 here: TYPO3 ELTS.
Link.external ViewHelper <f:link.external>
A ViewHelper for creating links to external targets.
Examples
Default
<f:link.external uri="https://www.typo3.org" target="_blank">external link</f:link.external>
Output:
<a href="https://www.typo3.org" target="_blank">external link</a>
Custom default scheme
<f:link.external uri="typo3.org" defaultScheme="ftp">external ftp link</f:link.external>
Output:
<a href="ftp://typo3.org">external ftp link</a>
Source code
Go to the source code of this ViewHelper: ExternalViewHelper.php (GitHub).
Arguments
The following arguments are available for <f:
:
additionalAttributes
-
- Type
- mixed
Additional tag attributes. They will be added directly to the resulting HTML tag.
data
-
- Type
- mixed
Additional data-* attributes. They will each be added with a "data-" prefix.
aria
-
- Type
- mixed
Additional aria-* attributes. They will each be added with a "aria-" prefix.
uri
-
- Type
- string
- Required
true
The URI that will be put in the href attribute of the rendered link tag
defaultScheme
-
- Type
- string
- Default
'https'
Scheme the href attribute will be prefixed with if specified $uri does not contain a scheme already
class
-
- Type
- string
CSS class(es) for this element
dir
-
- Type
- string
Text direction for this HTML element. Allowed strings: "ltr" (left to right), "rtl" (right to left)
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
style
-
- Type
- string
Individual CSS styles for this element
title
-
- Type
- string
Tooltip text of element
accesskey
-
- Type
- string
Keyboard shortcut to access this element
tabindex
-
- Type
- integer
Specifies the tab order of this element
onclick
-
- Type
- string
JavaScript evaluated for the onclick event
name
-
- Type
- string
Specifies the name of an anchor
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
target
-
- Type
- string
Specifies where to open the linked document