Download the PHP package gridprinciples/blade-forms without Composer
On this page you can find all versions of the php package gridprinciples/blade-forms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download gridprinciples/blade-forms
More information about gridprinciples/blade-forms
Files in gridprinciples/blade-forms
Package blade-forms
Short Description CSS-agnostic form rendering via Laravel Blade
License MIT
Homepage https://github.com/gridprinciples/blade-forms
Informations about the package blade-forms
CSS-agnostic form rendering via Laravel Blade
A set of Laravel Blade components useful for rendering basic, fully-accessible HTML forms in a Laravel app. The approach is barebones: CSS and JS is not included, but Tailwind (and possibly other framework) presets are planned.
Installation
You can install the package via composer:
You can publish the config file with:
Optionally, you can publish the views using
Usage
Result:
Text Input
Text inputs are, perhaps, the simplest form element. As with all elements, we can call it using the x-form
Blade prefix:
We can continue to decorate this input (and apply some readable indentation):
This gives us an input that's ready to use:
We can further customize the attributes of the wrapping <div>
s and the <label>
:
Results in:
Textarea
The textarea is used nearly identically to the Input component above:
Radio buttons
Radio controls should be rendered as a set, with options:
You can customize the option attributes by passing an array instead of a string as the label. Here's how to disable the "Maybe" option:
Checkbox
A single checkbox can stand alone:
Or, you can render a list of options:
Select
Select menu inputs must have options, and can be written in a very similar way to radio and checkbox lists:
Form
You can optionally create <form>
elements using this component, which includes some shortcuts to make things cleaner. Laravel apps typically have something like this:
Using the <x-form>
component, we can simplify things:
The component will automatically:
- add the CSRF field
- add the method based on which variable you fill with your submission URL. You can pass your URL using
get
,post
,put
,patch
, ordelete
, and the method will be set for you.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Greg Brock
- All Contributors
License
The MIT License (MIT). Please see License File for more information.