Download the PHP package ceddyg/bootforms without Composer
On this page you can find all versions of the php package ceddyg/bootforms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ceddyg/bootforms
More information about ceddyg/bootforms
Files in ceddyg/bootforms
Package bootforms
Short Description Just a Formbuilder with some Bootstrap specific conveniences. Remembers old input, retrieves error messages and handles all your boilerplate Bootstrap markup automatically.
License MIT
Informations about the package bootforms
Important: This package is not actively maintained. For bug fixes and new features, please fork.
BootForms
BootForms builds on top of my more general Form package by adding another layer of abstraction to rapidly generate markup for standard Bootstrap 3 forms. Probably not perfect for your super custom branded ready-for-release apps, but a huge time saver when you are still in the prototyping stage!
- Installation
- Using BootForms
- Basic Usage
- Customizing Elements
- Reduced Boilerplate
- Automatic Validation State
- Horizontal Forms
- Additional Tips
- Related Resources
Installing with Composer
You can install this package via Composer by running this command in your terminal in the root of your project:
Laravel
If you are using Laravel 4 or 5, you can get started very quickly by registering the included service provider.
Modify the providers
array in config/app.php
to include the BootFormsServiceProvider
:
Add the BootForm
facade to the aliases
array in config/app.php
:
You can now start using BootForms by calling methods directly on the BootForm
facade:
Outside of Laravel
Usage outside of Laravel is a little trickier since there's a bit of a dependency stack you need to build up, but it's not too tricky.
Note: You must provide your own implementations of
AdamWathan\Form\OldInputInterface
andAdamWathan\Form\ErrorStoreInterface
when not using the implementations meant for Laravel.
Using BootForms
Basic Usage
BootForms lets you create a label and form control and wrap it all in a form group in one call.
Note: Don't forget to
open()
forms before trying to create fields! BootForms needs to know if you opened a vertical or horizontal form before it can render a field, so you'll get an error if you forget.
Customizing Elements
If you need to customize your form elements in any way (such as adding a default value or placeholder to a text element), simply chain the calls you need to make and they will fall through to the underlying form element.
Attributes can be added either via the attribute
method, or by simply using the attribute name as the method name.
For more information about what's possible, check out the documentation for my basic Form package.
Reduced Boilerplate
Typical Bootstrap form boilerplate might look something like this:
BootForms makes a few decisions for you and allows you to pare it down a bit more:
Automatic Validation State
Another nice thing about BootForms is that it will automatically add error states and error messages to your controls if it sees an error for that control in the error store.
Essentially, this takes code that would normally look like this:
And reduces it to this:
...with the has-error
class being added automatically if there is an error in the session.
Horizontal Forms
To use a horizontal form instead of the standard basic form, simply swap the BootForm::open()
call with a call to openHorizontal($columnSizes)
instead:
Additional Tips
Hiding Labels
You can hide labels by chaining the hideLabel()
helper off of any element definition.
BootForm::text('First Name', 'first_name')->hideLabel()
The label will still be generated in the markup, but hidden using Bootstrap's .sr-only
class, so you don't reduce the accessibility of your form.
Help Blocks
You can add a help block underneath a form element using the helpBlock()
helper.
BootForm::text('Password', 'password')->helpBlock('A strong password should be long and hard to guess.')
Note: This help block will automatically be overridden by errors if there are validation errors.
Model Binding
BootForms makes it easy to bind an object to a form to provide default values. Read more about it here.
Related Resources
- Laravel Translatable BootForms, integrates BootForms with Dimsav's Laravel Translatable package