Link.file ViewHelper <f:link.file>
A ViewHelper for creating links to a file (FAL).
Examples
Link to a file
<f:link.file file="{file}" target="_blank">See file</f:link.file>
Copied!
Output of a public file:
<a href="https://example.com/fileadmin/path/to/file.jpg" target="_blank">See file</a>
Copied!
Output of a non-public file:
<a href="https://example.com/index.php?eID=dumpFile&t=f&f=123&token=79bce812" target="_blank">See file</a>
Copied!
Link to download a file
<f:link.file file="{file}" download="true" filename="alternative-name.jpg">Download file</f:link.file>
Copied!
Output of a public file:
<a href="https://example.com/fileadmin/path/to/file.jpg" download="alternative-name.jpg">Download file</a>
Copied!
Output of a non-public file:
<a href="https://example.com/index.php?eID=dumpFile&t=f&f=123&dl=1&fn=alternative-name.jpg&token=79bce812">Download file</a>
Copied!
Source code
Go to the source code of this ViewHelper: Link\FileViewHelper.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.file ViewHelper:
accesskey
-
- Type
- string
Keyboard shortcut to access this element
additionalAttributes
-
- Type
- array
Additional tag attributes. They will be added directly to the resulting HTML tag.
aria
-
- Type
- array
Additional aria-* attributes. They will each be added with a "aria-" prefix.
class
-
- Type
- string
CSS class(es) for this element
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)
download
-
- Type
- bool
Specifies if file should be downloaded instead of displayed
file
-
- Type
- TYPO3\CMS\Core\Resource\FileInterface
- Required
- 1
Specifies the file to create a link to
filename
-
- Type
- string
Specifies an alternative filename. If filename contains a file extension, this must be the same as from 'file'.
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
name
-
- Type
- string
Specifies the name of an anchor
onclick
-
- Type
- string
JavaScript evaluated for the onclick event
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
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