https://github.com/alexwenzel/bselements
Bootstrap shortcuts and elements for Laravel
https://github.com/alexwenzel/bselements
Last synced: 3 months ago
JSON representation
Bootstrap shortcuts and elements for Laravel
- Host: GitHub
- URL: https://github.com/alexwenzel/bselements
- Owner: alexwenzel
- Created: 2014-03-06T15:45:38.000Z (over 11 years ago)
- Default Branch: development
- Last Pushed: 2014-06-20T13:41:45.000Z (almost 11 years ago)
- Last Synced: 2025-01-10T18:27:56.680Z (5 months ago)
- Language: PHP
- Size: 273 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Laravel form elements for quick prototyping
This package provides form elements for **Laravel 4.2**, which are styled with [Bootstrap 3](http://getbootstrap.com/css/#forms).
* 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
````php
{{ 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')) }}
````
## Usage
First register the service provider ``Alexwenzel\Bselements\BselementsServiceProvider`` in ``app/conf/app.php``.
Then you can use it with the following syntax:
`````php
{{ 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)
````