Form.button ViewHelper <f:form.button>

Creates a button.

Examples

Defaults:

<f:form.button>Send Mail</f:form.button>
Copied!

Output:

<button type="submit" name="" value="">Send Mail</button>
Copied!

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>
Copied!

Output:

<button disabled="disabled" formmethod="post" formnovalidate="formnovalidate" type="reset" name="myForm[buttonName]" value="buttonValue">Cancel</button>
Copied!

Source code

Go to the source code of this ViewHelper: Form\ButtonViewHelper.php (GitHub).

Arguments

The following arguments are available for the form.button 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.

autofocus

autofocus
Type
string
Specifies that a button should automatically get focus when the page loads

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)

disabled

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

form

form
Type
string
Specifies one or more forms the button belongs to

formaction

formaction
Type
string
Specifies where to send the form-data when a form is submitted. Only for type="submit"

formenctype

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

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

formnovalidate
Type
string
Specifies that the form-data should not be validated on submission. Only for type="submit"

formtarget

formtarget
Type
string
Specifies where to display the response after submitting the form. Only for type="submit" (e.g. "_blank", "_self", "_parent", "_top", "framename")

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
Name of input tag

onclick

onclick
Type
string
JavaScript evaluated for the onclick event

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.

style

style
Type
string
Individual CSS styles for this element

tabindex

tabindex
Type
integer
Specifies the tab order of this element

title

title
Type
string
Tooltip text of element

type

type
Type
string
Default
'submit'
Specifies the type of button (e.g. "button", "reset" or "submit")

value

value
Type
mixed
Value of input tag