TYPO3 Logo
Fluid ViewHelper Reference
Release: 12.4

Loading data.

  • Global (f:*)
    • Asset
      • asset.css
      • asset.script
    • Be
      • Buttons
        • be.buttons.csh
      • Labels
        • be.labels.csh
      • Menus
        • be.menus.actionMenu
        • be.menus.actionMenuItem
        • be.menus.actionMenuItemGroup
      • Security
        • be.security.ifAuthenticated
        • be.security.ifHasRole
      • be.infobox
      • be.link
      • be.pageInfo
      • be.pagePath
      • be.pageRenderer
      • be.tableList
      • be.uri
    • Cache
      • cache.disable
      • cache.static
      • cache.warmup
    • Debug
      • debug.render
    • form
      • Select
        • form.select.optgroup
        • form.select.option
      • form.button
      • form.checkbox
      • form.countrySelect
      • form.hidden
      • form.password
      • form.radio
      • form.select
      • form.submit
      • form.textarea
      • form.textfield
      • form.upload
      • form.validationResults
    • Format
      • format.bytes
      • format.case
      • format.cdata
      • format.crop
      • format.currency
      • format.date
      • format.html
      • format.htmlentities
      • format.htmlentitiesDecode
      • format.htmlspecialchars
      • format.json
      • format.nl2br
      • format.number
      • format.padding
      • format.printf
      • format.raw
      • format.stripTags
      • format.trim
      • format.urlencode
    • Link
      • link.action
      • link.email
      • link.external
      • link.file
      • link.page
      • link.typolink
    • Sanitize
      • sanitize.html
    • Security
      • security.ifAuthenticated
      • security.ifHasRole
      • security.nonce
    • Transform
      • transform.html
    • Uri
      • uri.action
      • uri.external
      • uri.image
      • uri.page
      • uri.resource
      • uri.typolink
    • alias
    • case
    • cObject
    • comment
    • constant
    • count
    • cycle
    • debug
    • defaultCase
    • else
    • first
    • flashMessages
    • for
    • groupedFor
    • if
    • image
    • inline
    • join
    • last
    • layout
    • media
    • or
    • render
    • replace
    • section
    • spaceless
    • split
    • switch
    • then
    • translate
    • variable
  • Backend (be:*)
    • Link
      • link.documentation
      • link.editRecord
      • link.newRecord
    • Mfa
      • mfa.ifHasState
    • Toolbar
      • toolbar.attributes
      • toolbar.ifHasDropdown
    • TypoScript
      • typoScript.fineDiff
    • Uri
      • uri.editRecord
      • uri.newRecord
    • avatar
    • languageColumn
    • moduleLink
    • thumbnail
  • Core (core:*)
    • icon
    • iconForRecord
    • iconForResource
    • normalizedUrl
  • Form (formvh:*)
    • Be
      • be.maximumFileSize
      • be.renderContentElementPreview
    • Form
      • form.datePicker
      • form.timePicker
      • form.uploadedResource
    • form
    • gridColumnClassAutoConfiguration
    • render
    • renderAllFormValues
    • renderFormValue
    • renderRenderable
    • translateElementError
    • translateElementProperty
  • Contribution
  • Sitemap

Contributors Corner

  • View source of current document
  • How to edit
  • Edit current document on GitHub
  1. Fluid ViewHelper Reference
  2. Global (f:*)
  3. Link
  4. link.file
Report issue View source How to edit Edit on GitHub

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!

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

accesskey
Type
string
Keyboard shortcut to access this element

additionalAttributes

additionalAttributes
Type
array
Additional tag attributes. They will be added directly to the resulting HTML tag.

aria

aria
Type
array
Additional aria-* attributes. They will each be added with a "aria-" prefix.

class

class
Type
string
CSS class(es) for this element

data

data
Type
array
Additional data-* attributes. They will each be added with a "data-" prefix.

dir

dir
Type
string
Text direction for this HTML element. Allowed strings: "ltr" (left to right), "rtl" (right to left)

download

download
Type
bool
Specifies if file should be downloaded instead of displayed

file

file
Type
TYPO3\CMS\Core\Resource\FileInterface
Required
1
Specifies the file to create a link to

filename

filename
Type
string
Specifies an alternative filename. If filename contains a file extension, this must be the same as from 'file'.

id

id
Type
string
Unique (in this file) identifier for this HTML element.

lang

lang
Type
string
Language for this element. Use short names specified in RFC 1766

name

name
Type
string
Specifies the name of an anchor

onclick

onclick
Type
string
JavaScript evaluated for the onclick event

rel

rel
Type
string
Specifies the relationship between the current document and the linked document

rev

rev
Type
string
Specifies the relationship between the linked document and the current document

style

style
Type
string
Individual CSS styles for this element

tabindex

tabindex
Type
integer
Specifies the tab order of this element

target

target
Type
string
Specifies where to open the linked document

title

title
Type
string
Tooltip text of element
  • Previous
  • Next
Reference to the headline

Copy and freely share the link

This link target has no permanent anchor assigned. You can make a pull request on GitHub to suggest an anchor. The link below can be used, but is prone to change if the page gets moved.

Copy this link into your TYPO3 manual.

  • Home
  • Contact
  • Issues
  • Repository

Last rendered: Apr 20, 2025 09:15

© since 2018 by the TYPO3 contributors
  • Legal Notice
  • Privacy Policy
OSZAR »