alexwenzel/bselements

Bootstrap shortcuts and elements for Laravel

v1.2.0 2014-06-20 13:39 UTC

README

This package provides form elements for Laravel 4.2, which are styled with Bootstrap 3.

  • shows first error message in help text area
  • labels the input with the error class
  • automatically repopulates the form elements

There is a demo page included in this package: use View::make('bselements::demopage').

Example

{{ BsForm::useViewErrorBag($errors) }}
{{ BsForm::info('Info', 'Infotext', array()) }}
{{ BsForm::text('text', 'Text') }}
{{ BsForm::textAddon('left', 'Demo', 'textaddon1', 'Text-Addon') }}
{{ BsForm::textAddon('right', 'Demo', 'textaddon2', 'Text-Addon') }}
{{ BsForm::password('password', 'Password') }}
{{ BsForm::file('file', 'File') }}
{{ BsForm::select('select', 'Select', array(''=>'-- Choose --','s1'=>'Select 1','s2'=>'Select 2','s3'=>'Select 3')) }}
{{ BsForm::textarea('textarea', 'Textarea') }}
{{ BsForm::radioGroup('radiogroup', 'radioGroup', array('r1'=>'1','r2'=>'2','r3'=>'3')) }}
{{ BsForm::checkboxGroup('checkboxGroup', array('c1'=>'one','c2'=>'two','c3'=>'three')) }}

checkbox

checkbox

Usage

First register the service provider Alexwenzel\Bselements\BselementsServiceProvider in app/conf/app.php.

Then you can use it with the following syntax:

{{ BsForm::text('text', 'Text') }}
````

Bootstrap assets (CSS/JS) are not included! Include them yourself.

## Form elements

### Injecting validation messages

You can inject your validation messages within you template into the BsForm class.

````php
BsForm::useViewErrorBag($errors)
````

### Info

Generates a text input look-alike field, without any functionality.

````php
BsForm::info($label, $text, array $attributes = array())
````

### Text

Generates a text input element.

````php
BsForm::text($id, $label, array $attributes = array())
````

### Text Addon

Generates a text input element with addon.

````php
BsForm::textAddon($addonDirection, $addonContent, $id, $label, array $attributes = array())
````

  * ``$addonDirection`` can be ``left`` or ``right``
  * ``$addonContent`` can be any HTML/String

### File

Generates a file input element.

````php
BsForm::file($id, $label, array $attributes = array())
````

### Select

Generates a select element.

````php
BsForm::select($id, $label, array $elements, array $attributes = array())
````

### Password

Generates a password input element.

````php
BsForm::password($id, $label, array $attributes = array())
````

### Textarea

Generates a textarea element.

````php
BsForm::textarea($id, $label, array $attributes = array())
````

### Radio Group

Generates a group of radio elements.

````php
BsForm::radioGroup($id, $label, array $values)
````

### Checkbox Group

Generates a group of checkbox elements.

````php
BsForm::checkboxGroup($label, array $values)
````