Attention

TYPO3 v10 has reached end-of-life as of April 30th 2023 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 v10 here: TYPO3 ELTS.

link.external¶

A ViewHelper for creating links to external targets.

Examples¶

Default¶

<f:link.external uri="http://www.typo3.org" target="_blank">external link</f:link.external>

Output:

<a href="http://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>

Arguments¶

additionalAttributes¶

DataType: mixed
Required: false
Description: Additional tag attributes. They will be added directly to the resulting HTML tag.

data¶

DataType: mixed
Required: false
Description: Additional data-* attributes. They will each be added with a "data-" prefix.

uri¶

DataType: string
Required: true
Description: The URI that will be put in the href attribute of the rendered link tag

defaultScheme¶

DataType: string
Default: 'http'
Required: false
Description: Scheme the href attribute will be prefixed with if specified $uri does not contain a scheme already

class¶

DataType: string
Required: false
Description: CSS class(es) for this element

dir¶

DataType: string
Required: false
Description: Text direction for this HTML element. Allowed strings: "ltr" (left to right), "rtl" (right to left)

id¶

DataType: string
Required: false
Description: Unique (in this file) identifier for this HTML element.

lang¶

DataType: string
Required: false
Description: Language for this element. Use short names specified in RFC 1766

style¶

DataType: string
Required: false
Description: Individual CSS styles for this element

title¶

DataType: string
Required: false
Description: Tooltip text of element

accesskey¶

DataType: string
Required: false
Description: Keyboard shortcut to access this element

tabindex¶

DataType: integer
Required: false
Description: Specifies the tab order of this element

onclick¶

DataType: string
Required: false
Description: JavaScript evaluated for the onclick event

name¶

DataType: string
Required: false
Description: Specifies the name of an anchor

rel¶

DataType: string
Required: false
Description: Specifies the relationship between the current document and the linked document

rev¶

DataType: string
Required: false
Description: Specifies the relationship between the linked document and the current document

target¶

DataType: string
Required: false
Description: Specifies where to open the linked document