TYPO3 Logo
Fluid ViewHelper Reference
Release: 11.5

Loading data.

  • typo3/backend
    • arrayBrowser
    • avatar
    • languageColumn
    • moduleLayout
    • moduleLink
    • thumbnail
    • link
      • link.editRecord
      • link.newRecord
    • mfa
      • mfa.ifHasState
    • moduleLayout
      • moduleLayout.menuItem
      • moduleLayout.menu
      • button
        • moduleLayout.button.linkButton
        • moduleLayout.button.shortcutButton
    • uri
      • uri.editRecord
      • uri.newRecord
  • typo3/core
    • iconForRecord
    • iconForResource
    • icon
    • normalizedUrl
    • form
      • form.typoScriptConstants
  • typo3/fluid
    • base
    • cObject
    • debug
    • flashMessages
    • form
    • image
    • media
    • render
    • translate
    • asset
      • asset.css
      • asset.script
    • be
      • be.container
      • be.infobox
      • be.link
      • be.pageInfo
      • be.pagePath
      • be.pageRenderer
      • be.tableList
      • be.uri
      • buttons
        • be.buttons.csh
        • be.buttons.shortcut
      • labels
        • be.labels.csh
      • menus
        • be.menus.actionMenuItemGroup
        • be.menus.actionMenuItem
        • be.menus.actionMenu
      • security
        • be.security.ifAuthenticated
        • be.security.ifHasRole
    • debug
      • debug.render
    • form
      • form.button
      • form.checkbox
      • form.hidden
      • form.password
      • form.radio
      • form.select
      • form.submit
      • form.textarea
      • form.textfield
      • form.upload
      • form.validationResults
      • select
        • form.select.optgroup
        • form.select.option
    • format
      • format.bytes
      • format.case
      • format.crop
      • format.currency
      • format.date
      • format.html
      • format.htmlentitiesDecode
      • format.htmlentities
      • format.json
      • format.nl2br
      • format.number
      • format.padding
      • format.stripTags
      • format.urlencode
    • link
      • link.action
      • link.email
      • link.external
      • link.file
      • link.page
      • link.typolink
    • sanitize
      • sanitize.html
    • security
      • security.ifAuthenticated
      • security.ifHasRole
    • transform
      • transform.html
    • uri
      • uri.action
      • uri.email
      • uri.external
      • uri.image
      • uri.page
      • uri.resource
      • uri.typolink
  • typo3fluid/fluid
    • alias
    • case
    • comment
    • count
    • cycle
    • debug
    • defaultCase
    • else
    • for
    • groupedFor
    • if
    • inline
    • layout
    • or
    • render
    • section
    • spaceless
    • switch
    • then
    • variable
    • cache
      • cache.disable
      • cache.static
      • cache.warmup
    • format
      • format.cdata
      • format.htmlspecialchars
      • format.printf
      • format.raw
  • Contribution
  • Sitemap

Contributors Corner

  • View source of current document
  • How to edit
  • Edit current document on GitHub
  1. Fluid ViewHelper Reference
  2. typo3/fluid
  3. link
  4. link.file
Report issue View source How to edit Edit on GitHub

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.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: FileViewHelper.php (GitHub).

Arguments

The following arguments are available for <f:link.file>:

Name Type Default
additionalAttributes
mixed
data
mixed
aria
mixed
file
mixed
download
boolean
filename
string
class
string
dir
string
id
string
lang
string
style
string
title
string
accesskey
string
tabindex
integer
onclick
string
name
string
rel
string
rev
string
target
string

additionalAttributes

additionalAttributes
Type
mixed

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

data

data
Type
mixed

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

aria

aria
Type
mixed

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

file

file
Type
mixed
Required

true

Specifies the file to create a link to

download

download
Type
boolean

Specifies if file should be downloaded instead of displayed

filename

filename
Type
string

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

class

class
Type
string

CSS class(es) for this element

dir

dir
Type
string

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

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

style

style
Type
string

Individual CSS styles for this element

title

title
Type
string

Tooltip text of element

accesskey

accesskey
Type
string

Keyboard shortcut to access this element

tabindex

tabindex
Type
integer

Specifies the tab order of this element

onclick

onclick
Type
string

JavaScript evaluated for the onclick event

name

name
Type
string

Specifies the name of an anchor

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

target

target
Type
string

Specifies where to open the linked document

  • 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: Oct 16, 2024 07:43

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