Important: This package is not actively maintained. For bug fixes and new features, please fork.
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!
You can install this package via Composer by running this command in your terminal in the root of your project:
composer require adamwathan/bootforms
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
:
'providers' => [
//...
'AdamWathan\BootForms\BootFormsServiceProvider'
],
Add the BootForm
facade to the aliases
array in config/app.php
:
'aliases' => [
//...
'BootForm' => 'AdamWathan\BootForms\Facades\BootForm'
],
You can now start using BootForms by calling methods directly on the BootForm
facade:
BootForm::text('Email', 'email');
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.
$formBuilder = new AdamWathan\Form\FormBuilder;
$formBuilder->setOldInputProvider($myOldInputProvider);
$formBuilder->setErrorStore($myErrorStore);
$formBuilder->setToken($myCsrfToken);
$basicBootFormsBuilder = new AdamWathan\BootForms\BasicFormBuilder($formBuilder);
$horizontalBootFormsBuilder = new AdamWathan\BootForms\HorizontalFormBuilder($formBuilder);
$bootForm = new AdamWathan\BootForms\BootForm($basicBootFormsBuilder, $horizontalBootFormsBuilder);
Note: You must provide your own implementations of AdamWathan\Form\OldInputInterface
and AdamWathan\Form\ErrorStoreInterface
when not using the implementations meant for Laravel.
BootForms lets you create a label and form control and wrap it all in a form group in one call.
// <form method="POST">
// <div class="form-group">
// <label for="field_name">Field Label</label>
// <input type="text" class="form-control" id="field_name" name="field_name">
// </div>
// </form>
{!! BootForm::open() !!}
{!! BootForm::text('Field Label', 'field_name') !!}
{!! BootForm::close() !!}
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.
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.
// <div class="form-group">
// <label for="first_name">First Name</label>
// <input type="text" class="form-control" id="first_name" name="first_name" placeholder="John Doe">
// </div>
BootForm::text('First Name', 'first_name')->placeholder('John Doe');
// <div class="form-group">
// <label for="color">Color</label>
// <select class="form-control" id="color" name="color">
// <option value="red">Red</option>
// <option value="green" selected>Green</option>
// </select>
// </div>
BootForm::select('Color', 'color')->options(['red' => 'Red', 'green' => 'Green'])->select('green');
// <form method="GET" action="/users">
BootForm::open()->get()->action('/users');
// <div class="form-group">
// <label for="first_name">First Name</label>
// <input type="text" class="form-control" id="first_name" name="first_name" value="John Doe">
// </div>
BootForm::text('First Name', 'first_name')->defaultValue('John Doe');
For more information about what's possible, check out the documentation for my basic Form package.
Typical Bootstrap form boilerplate might look something like this:
<form>
<div class="form-group">
<label for="first_name">First Name</label>
<input type="text" class="form-control" name="first_name" id="first_name">
</div>
<div class="form-group">
<label for="last_name">Last Name</label>
<input type="text" class="form-control" name="last_name" id="last_name">
</div>
<div class="form-group">
<label for="date_of_birth">Date of Birth</label>
<input type="date" class="form-control" name="date_of_birth" id="date_of_birth">
</div>
<div class="form-group">
<label for="email">Email address</label>
<input type="email" class="form-control" name="email" id="email">
</div>
<div class="form-group">
<label for="password">Password</label>
<input type="password" class="form-control" name="password" id="password">
</div>
<button type="submit" class="btn btn-default">Submit</button>
</form>
BootForms makes a few decisions for you and allows you to pare it down a bit more:
{!! BootForm::open() !!}
{!! BootForm::text('First Name', 'first_name') !!}
{!! BootForm::text('Last Name', 'last_name') !!}
{!! BootForm::date('Date of Birth', 'date_of_birth') !!}
{!! BootForm::email('Email', 'email') !!}
{!! BootForm::password('Password', 'password') !!}
{!! BootForm::submit('Submit') !!}
{!! BootForm::close() !!}
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:
<div class="form-group {!! $errors->has('first_name') ? 'has-error' : '' !!}">
<label for="first_name">First Name</label>
<input type="text" class="form-control" id="first_name">
{!! $errors->first('first_name', '<p class="help-block">:message</p>') !!}
</div>
And reduces it to this:
{!! BootForm::text('First Name', 'first_name') !!}
...with the has-error
class being added automatically if there is an error in the session.
To use a horizontal form instead of the standard basic form, simply swap the BootForm::open()
call with a call to openHorizontal($columnSizes)
instead:
// Width in columns of the left and right side
// for each breakpoint you'd like to specify.
$columnSizes = [
'sm' => [4, 8],
'lg' => [2, 10]
];
{!! BootForm::openHorizontal($columnSizes) !!}
{!! BootForm::text('First Name', 'first_name') !!}
{!! BootForm::text('Last Name', 'last_name') !!}
{!! BootForm::text('Date of Birth', 'date_of_birth') !!}
{!! BootForm::email('Email', 'email') !!}
{!! BootForm::password('Password', 'password') !!}
{!! BootForm::submit('Submit') !!}
{!! BootForm::close() !!}
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.
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.
BootForms makes it easy to bind an object to a form to provide default values. Read more about it here.
BootForm::open()->action( route('users.update', $user) )->put()
BootForm::bind($user)
BootForm::close()
- Laravel Translatable BootForms, integrates BootForms with Dimsav's Laravel Translatable package
bootforms's People
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. ๐๐๐
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google โค๏ธ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.