Forms
Introduction
The form
plugin function allows you to initialize, configure, and display a form builder inline within a view.
Displaying Forms
The easiest way to display a form is to use the form
function and specify the namespace
and stream
slug.
The render
method will trigger display but it is optional as __toString
will result in the same thing.
{{ form('books', 'reviews').render()|raw }}
You may want to take more control and set the form to a variable and use it.
{% set form = form('books', 'reviews') %}
{{ form.open|raw }}
{% for field in form.fields %}
<div class="{{ field.input_name }}-wrapper">
{{ field.render()|raw
</div>
{% endfor %}
{{ form.actions|raw }}
{{ form.close|raw }}
Binding Form Builders
The form
function makes use of a generic form builder
class by default. Often times, however, you want to build and use a specific form builder. The easiest way to use said builder in the form
function is to bind
it to the service container.
You can define a form builder binding
within a service provider.
Service Providers{.link} Form Builders{.link}
protected $bindings = [
'employment_application_form' => \Anomaly\ExampleModule\Applications\Form\PublicApplicationFormBuilder::class
];
After binding the form builder you can use it by specifying the bound key
.
{{ form('employment_application').render()|raw }}
Form Components
You can work with form components
similarly as to how you would work with a form builder
.
Form Builders{.link}
Form Components{.link}
Configuring Forms
You can configure forms inline to an extent. Which is sometimes easier than writing a dedicated form builder.
Generally you can interact with the form criteria
the same as you would with a form builder
instance.
Form Builders{.link}
Form Configuration{.link}
Setting Options
You can set options by using the setOption
method.
Form Options{.link}
{{ form('employment_application')
.setOption('redirect', url_previous())
.render()|raw }}