form_*()
Functions prefixed with form_ perform tasks that are useful when dealing with forms. The helper maps directly to the Form PHP class and its methods. For example:
{{ form_close() }}
is the PHP equivalent of the following:
<?= Form::close() ?>
NOTE: Methods in camelCase should be converted to snake_case.
form_open()
Outputs a standard <form> opening tag along with the _session_key and _token hidden fields for CSRF protection. If you are using the AJAX Framework, it is recommended that you use form_ajax() instead.
{{ form_open() }}
Attributes can be passed in the first argument.
{{ form_open({ class: 'form-horizontal' }) }}
The above example would output as the following:
<form class="form-horizontal">
There are some special options that can also be used alongside the attributes.
{{ form_open({ request: 'onUpdate' }) }}
The function support the following options:
| Option | Description |
|---|---|
method |
Request method. Corresponds to the method FORM tag attribute. Eg: POST, GET, PUT, DELETE |
request |
A handler name to execute on the server when the form is posted. See the Handling forms article for details about the event handlers. |
url |
Specifies URL to post the form to. Corresponds to the action FORM tag attribute. |
files |
Determines whether the form will submit files. Accepted values: true and false. |
model |
A model object for the form model binding. |
form_ajax()
Outputs an AJAX enabled FORM opening tag. The first parameter of the form_ajax() function is the AJAX handler name. The handler can be defined in the layout or page PHP section code, it can also be defined in a component. You may find more information about AJAX in the AJAX Framework article.
{{ form_ajax('onUpdate') }}
Attributes can be passed in the second argument.
{{ form_ajax('onSave', { class: 'form-horizontal'}) }}
The above example would output as the following:
<form data-request="onSave" class="form-horizontal">
There are some special options that can also be used alongside the attributes.
{{ form_ajax('onDelete', { data: { id: 2 }, confirm: 'Really delete this record?' }) }}
{{ form_ajax('onRefresh', { update: { statistics: '#statsPanel' } }) }}
NOTE: When attempting to reference a component's alias with
__SELF__as an argument toform_ajax()you must first build the string you wish to use outside of the call itself. Example:
{% set targetPartial = "'" ~ __SELF__ ~ "::statistics': '#statsPanel'" %}
{{ form_ajax('onUpdate', { update: targetPartial }) }}
The function support the following options:
| Option | Description |
|---|---|
success |
JavaScript string to execute on successful result. |
error |
JavaScript string to execute on failed result. |
confirm |
A confirmation message to display before sending the request. |
redirect |
On successful result, redirect to a URL. |
update |
An array of partials to update on success in the following format: { 'partial': '#element' }. |
data |
Extra data to include with the request in the following format: { 'myvar': 'myvalue' }. |
form_close()
Outputs a standard FORM closing tag. This tag is generally available to provide consistency in usage.
{{ form_close() }}
The above example would output as the following:
</form>
form_token()
Outputs a _token hidden fields for CSRF protection.
{{ form_token() }}
The above example would output as the following:
<input name="_token" type="hidden" value="...">
form_submit()
Outputs an input element of type submit. This tag is generally available to provide consistency in usage.
{{ form_submit() }}
The above example would output as the following:
<input type="submit">
Passing attributes to the generated element
You can pass additional attributes to the Form::open() method by passing an array of attribute names and values to be rendered on the final generated <form> element.
<?= Form::open(array('id' => 'example', 'class' => 'something')) ?>
// ..
<?= Form::close() ?>
The above example would output the following:
<form method="POST" action="" accept-charset="UTF-8" id="example" class="something">
</form>