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.
Form.button ViewHelper <f:form.button>
Creates a button.
Examples
Defaults:
<f:form.button>Send Mail</f:form.button>
Output:
<button type="submit" name="" value="">Send Mail</button>
Disabled cancel button with some HTML5 attributes:
<f:form.button type="reset" disabled="disabled"
name="buttonName" value="buttonValue"
formmethod="post" formnovalidate="formnovalidate"
>
Cancel
</f:form.button>
Output:
<button disabled="disabled" formmethod="post" formnovalidate="formnovalidate" type="reset" name="myForm[buttonName]" value="buttonValue">Cancel</button>
Source code
Go to the source code of this ViewHelper: ButtonViewHelper.php (GitHub).
Arguments
The following arguments are available for <f::
additionalAttributes
-
- Type
- mixed
Additional tag attributes. They will be added directly to the resulting HTML tag.
data
-
- Type
- mixed
Additional data-* attributes. They will each be added with a "data-" prefix.
aria
-
- Type
- mixed
Additional aria-* attributes. They will each be added with a "aria-" prefix.
name
-
- Type
- string
Name of input tag
value
-
- Type
- mixed
Value of input tag
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.
autofocus
-
- Type
- string
Specifies that a button should automatically get focus when the page loads
disabled
-
- Type
- string
Specifies that the input element should be disabled when the page loads
form
-
- Type
- string
Specifies one or more forms the button belongs to
formaction
-
- Type
- string
Specifies where to send the form-data when a form is submitted. Only for type="submit"
formenctype
-
- Type
- string
Specifies how form-data should be encoded before sending it to a server. Only for type="submit" (e.g. "application/x-www-form-urlencoded", "multipart/form-data" or "text/plain")
formmethod
-
- Type
- string
Specifies how to send the form-data (which HTTP method to use). Only for type="submit" (e.g. "get" or "post")
formnovalidate
-
- Type
- string
Specifies that the form-data should not be validated on submission. Only for type="submit"
formtarget
-
- Type
- string
Specifies where to display the response after submitting the form. Only for type="submit" (e.g. "_blank", "_self", "_parent", "_top", "framename")
class
-
- Type
- string
CSS class(es) for this element
dir
-
- Type
- string
Text direction for this HTML element. Allowed strings: "ltr" (left to right), "rtl" (right to left)
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
style
-
- Type
- string
Individual CSS styles for this element
title
-
- Type
- string
Tooltip text of element
accesskey
-
- Type
- string
Keyboard shortcut to access this element
tabindex
-
- Type
- integer
Specifies the tab order of this element
onclick
-
- Type
- string
JavaScript evaluated for the onclick event
type
-
- Type
- string
- Default
'submit'
Specifies the type of button (e.g. "button", "reset" or "submit")