Splade comes with a set of Form Components to rapidly build forms. It supports model binding and validation, includes default styling, and is still fully customizable! It integrates with Autosize to automatically adjust textarea height, Choices.js to make selects searchable and taggable, Flatpickr to provide a powerful datetime picker, FilePond for smooth file uploads, and Jodit to provide a WYSIWYG editor.
All elements allow passing in a label, which will be rendered above the input element. Just like other attributes, the label can also be computed.
<x-splade-form><x-splade-input name="email" label="Email address" /><x-splade-input name="username" :label="__('Username')" /><x-splade-submit /></x-splade-form>
If you want to eliminate the
splade prefix, you may update the
blade.component_prefix key in the
splade.php configuration file:
return [...'blade' => ['component_prefix' => '',],...];
This will result in more readable
To bind a resource to a form, for example, an Eloquent Model, you may use the
default attribute. Instead of using the
v-model attribute on the input element, you may now use the
name attribute. Splade will take care of the two-way binding with the User model.
<x-splade-form :default="$user"><x-splade-input name="email" placeholder="Email address" /></x-splade-form>
Note that the user data is passed to the frontend, so be careful with sensitive attributes. By default, it only passes the attributes to the frontend that you use. So in this example, only the
The validation errors are populated automatically based on the
name attribute. This behavior is enabled by default for all elements except
radio elements, as you don't want to repeat the error for each element. In that case, you may use a
<x-splade-group> component, which you can read more about on its page.
To disable validation errors on an element, you may use the
<x-splade-input name="email" :show-errors="false" />
If you want to override how Splade will resolve the validation, you may use the
<x-splade-input name="email" validation-key="email_address" />
By default, Splade scrolls to the first element with a validation error. You may disable this with the
Splade escapes Validation errors by default, so if you use raw HTML in one of your messages, Vue won't insert those as plain HTML. If you want to disable this behavior, set the
blade.escape_validation_messages key in the
splade.php configuration file to
false. Only disable this on trusted content and never on user-provided content, as it may lead to XSS attacks.
In addition to building forms in Blade templates, you may also build forms in PHP with the Form Builder.