Form.upload ViewHelper <f:form.upload>

A ViewHelper which generates an <input type="file"> HTML element. Make sure to set enctype="multipart/form-data" on the form!

Examples

Example:

<f:form.upload name="file" />
Copied!

Output:

<input type="file" name="file" />
Copied!

Source code

Go to the source code of this ViewHelper: UploadViewHelper.php (GitHub).

Arguments

The following arguments are available for <f:form.upload>:

Name Type Default
mixed
mixed
mixed
string
mixed
string
string
string
string 'f3-form-error'
string
string
string
string
string
string
string
integer
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.

name

name
Type
string

Name of input tag

value

value
Type
mixed

Value of input tag

property

property
Type
string

Name of Object Property. If used in conjunction with <f:form object="...">, the "name" property will be ignored, while "value" can be used to specify a default field value instead of the object property value.

disabled

disabled
Type
string

Specifies that the input element should be disabled when the page loads

multiple

multiple
Type
string

Specifies that the file input element should allow multiple selection of files

errorClass

errorClass
Type
string
Default
'f3-form-error'

CSS class to set if there are errors for this ViewHelper

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