alexwenzel/bselements

Bootstrap shortcuts and elements for Laravel

Downloads

148

Stars

0

Version

v1.2.0

Laravel form elements for quick prototyping

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.

<a class="anchor" name="form-elements"></a>
## Form elements

<a class="anchor" name="injecting-validation-messages"></a>
### Injecting validation messages

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

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

<a class="anchor" name="info"></a>
### Info

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

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

<a class="anchor" name="text"></a>
### Text

Generates a text input element.

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

<a class="anchor" name="text-addon"></a>
### 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

<a class="anchor" name="file"></a>
### File

Generates a file input element.

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

<a class="anchor" name="select"></a>
### Select

Generates a select element.

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

<a class="anchor" name="password"></a>
### Password

Generates a password input element.

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

<a class="anchor" name="textarea"></a>
### Textarea

Generates a textarea element.

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

<a class="anchor" name="radio-group"></a>
### Radio Group

Generates a group of radio elements.

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

<a class="anchor" name="checkbox-group"></a>
### Checkbox Group

Generates a group of checkbox elements.

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

Author

alexwenzel