Back

buttonTo()

Creates a form containing a single button that submits to the URL. The URL is built the same way as the linkTo function.

Name	Type	Required	Default	Description
text	string	No		The text content of the button.
image	string	No		If you want to use an image for the button pass in the link to it here (relative from the `images` folder).
route	string	No		Name of a route that you have configured in `config/routes.cfm`.
controller	string	No		Name of the controller to include in the URL.
action	string	No		Name of the action to include in the URL.
key	any	No		Key(s) to include in the URL.
params	string	No		Any additional parameters to be set in the query string (example: `wheels=cool&x=y`). Please note that CFWheels uses the `&` and `=` characters to split the parameters and encode them properly for you. However, if you need to pass in `&` or `=` as part of the value, then you need to encode them (and only them), example: `a=cats%26dogs%3Dtrouble!&b=1`.
anchor	string	No		Sets an anchor name to be appended to the path.
onlyPath	boolean	No	true	If `true`, returns only the relative URL (no protocol, host name or port).
host	string	No		Set this to override the current host.
protocol	string	No		Set this to override the current protocol.
port	numeric	No	0	Set this to override the current port number.
encode	any	No	true	When set to `true`, encodes tag content, attribute values, and URLs so that Cross Site Scripting (XSS) attacks can be prevented. Set to `attributes` to only encode attribute values and not tag content.

#buttonTo(text="Delete Account", action="perFormDelete", disable="Wait...")#

<!--- apply attributes to the input element by prefixing any arguments with "input"--->
#buttonTo(text="Edit", action="edit", inputId="edit-button", inputClass="edit-button-class")#