Download the PHP package watson/bootstrap-form without Composer

BootstrapForm, forms for Laravel 5

This is a package for simply creating Bootstrap 3 styled form groups in Laravel 5. It extends the normal form builder to provide you with horizontal form groups completed with labels, error messages and appropriate class usage.

Introduction

Simply use the BootstrapForm facade in the place of the Form facade when you want to generate a Bootstrap 3 form group.

And you'll get back the following:

Of course, if there are errors for that field it will even populate them.

Installation

First, require the package using Composer.

Now, add these service providers to your config/app.php file (don't add the HtmlServiceProvider if you already have it).

And finally add these to the aliases array (note: Form and Html must be listed before BootstrapForm):

Feel free to use a different alias for BootstrapForm if you'd prefer something shorter.

Configuration

There are a number of configuration options available for BootstrapForm. Run the following Artisan command to publish the configuration option to your config directory:

Horizontal form sizes

When using a horizontal form you can specify here the default sizes of the left and right columns. Note you can specify as many classes as you like for each column for improved mobile responsiveness, for example:

Display errors

By default this package will only display the first validation error for each field. If you'd instead like to list out all the validation errors for a field, simply set this configuration option to true.

Usage

Opening a form

BootstrapForm has improved the process of opening forms, both in terms of providing Bootstrap classes as well as managing models for model-based forms.

If a model is passed to the open method, it will be configured to use the update route with the PUT method. Otherwise it will point to the store method as a POST request. This way you can use the same opening tag for a form that handles creating and saving.

Routing with parameters

If the route takes parametersyou can pass them by replacing the route or action name string bwith an array. The first entry is the string for route name, followed by the parameters as you'd pass them to the route function.

Form variations

There are a few helpers for opening the different kinds of Bootstrap forms. By default, open() will use the the form style that you have set in the configuration file. These helpers take the same input as the open() method.

If you want to change the columns for a form for a deviation from the settings in your configuration file, you can also set them through the $options array.

Text inputs

Here are the various methods for text inputs. Note that the method signatures are relatively close to those provided by the Laravel form builder but take a parameter for the form label.

Checkbox and radio button inputs

Checkboxes and radio buttons are a little bit different and generate different markup.

View the method signature for configuration options.

Same goes for radio inputs.

Multiple checkboxes and radio buttons

By simply passing an array of value/label pairs you can generate a group of checkboxes or radio buttons easily.

Submit button

Closing the form

Labels

Hide Labels

You may hide an element's label by setting the the value to false.

Labels with HTML

To include HTML code inside a label:

Help Text

You may pass a help_text option to any field to have Bootstrap Help Text appended to the rendered form group.

Form input group (suffix and prefix)

Add prefix and/or suffix to any input - you can add text, icon and buttons.