Yii 2.0: yii2-bootstrap-form-helpers

Collection of JQuery plugins to enhance your Yii2 apps
3 followers

Bootstrap Form Helpers Widget library allows you to use the amazing collection of jQuery plugins created by Vincent Lamanna and help you build better looking forms.

Installation

The preferred way to install this extension is through composer.

Either run php composer.phar require "2amigos/yii2-bootstrap-form-helpers-library" "*" or add "2amigos/yii2-bootstrap-form-helpers-library" : "*"

to the require section of your application's composer.json file.

Usage

The library comes with the following widgets:

  • ColorPicker
  • CountryPicker
  • CurrencyPicker
  • DatePicker
  • FontPicker
  • FontSizePicker
  • GoogleFontPicker
  • LanguagePicker
  • NumberInput
  • PhoneInput
  • Select
  • Slider
  • StatePicker
  • TimePicker
  • TimeZonePicker

Pickers are Select are DropDownLists that have pretty much work the same in terms of usage. So, the following examples shows how to use an input and a DropDownList. I am sure you will figure out how to make use of the others until we have written the proper documentation site for all our extensions.

// using Select Widget, the custom select HTML element of the library
 
dosamigos\formhelpers\Select::widget([
    'model' => $model,
    'attribute' => 'attributeName',
    'items' => [
        '1' => 'One option',
        '2' => 'Another option'
    ],
    // for all possible client options, please see
    // http://bootstrapformhelpers.com/select/#jquery-plugins
    'clientOptions' => [
        'filter' => 'true' // boolean must be as a string
    ]
]);
 
// using the NumberInput
dosamigos\formhelpers\NumberInput::widget([
    'model' => $model,
    'attribute' => 'updated_at',
    // not required if we use it with yii\bootstrap\ActiveForm
    'options' => ['class' => 'form-control'],
    // for all possible client options, please see
    // http://bootstrapformhelpers.com/number/#jquery-plugins
    'clientOptions' => [
        'min' => 20,
        'max' => 40
    ]
]);
// (remember that you can also use the following format)
use dosamigos\formhelpers\NumberInput;
 
$form->input($model, 'attribute')->widget(NumberInput::className(),['clientOptions' => ['min' => 20, 'max' => 40]]);
 
// using the DatePicker with a selected language
dosamigos\formhelpers\DatePicker::widget([
    'model' => $model,
    'attribute' => 'updated_at',
    'language' => 'es_ES',
    'clientOptions' => [
        'format' => 'm/d/y',
    ]
]);
 
// using the CurrencyPicker with flags
dosamigos\formhelpers\CurrencyPicker::widget([
    'model' => $model,
    'attribute' => 'updated_at',
    // important! if we don't use the custom select HTML we won't see the flags
    'selectBox' => true,
    'clientOptions' => [
        'flags' => 'true',
    ]
])

Further Information

For further information regarding the multiple options for the different plugins please visit its website

Resources

2amigOS!
web development has never been so fun
www.2amigos.us

Be the first person to leave a comment

Please to leave your comment.

Create extension
Downloads
No downloadable files yet