freesoftwarefactory/yii2-select3

a specialized jquery based DropDownList component displaying checkboxes as options.

Select3 (yii2-select3)

Display a hybrid between a DropDownList and a Multi-selectable checkboxes., _(*1)

platform: Yii Framework 2.0, _(*2)

author: Cristian Salazar chileshift.cl/freesoftwarefactory, _(*3)

Preview

, _(*4)

Usage

1. Via composer,

"require": {
    "php": ">=5.4.0",
    "freesoftwarefactory/yii2-select3": "(put version here)"
},

1. In your View

 "Chevrolet",
    'opt2' => "Mazda",
    'opt3' => "Audi",
];



?>

'form1', ]); ?>




    

        =$form->field($model, 'someAttributeInYourModel')
            ->widget(Select3Widget::className(), 
                [
                    'prompt' => 'Select Provider',
                    'options' => $options,
                    'allSelectable' => true,
                    'allSelectableLabel' => "(All)",
                    'visibleAtStartup' => false,
                ]) ?>
    

Receving Values from this Control

Values are base64+json encoded, that is, when you submits a form using this control then you will have something similar to:, _(*5)

eyJvcHQxIjp0cnVlLCJvcHQyIjp0cnVlLCJvcHQzIjpmYWxzZX0=

Which is a base64 encoded version of this:, _(*6)

 {"opt1":true,"opt2":true,"opt3":false}

So, you can just call:, _(*7)

$values = json_decode(base64_decode($model->yourAttribute),true);

Or... just call :), _(*8)

$values =  Select3Widget::getDecodedValueFrom($model, 'yourAttribute');

More functions

1. load items via javascript by calling:

$.fn.select3load($('#widgetid') , { 123 : some , 456 : thing });

1. Disable the control by passing:

[
    'disable'=>true,
]

1. Disable/Check some items at startup by calling

[
    'disabledOptions' => ['somekeydisabled'],

    'autoSelectOptions' => ['somekeySelectedFromTheBeginning'],
]

1. Javascript events to listen for changes

$this->registerJs("
    $(document).on('select3-changed', [], function(e, options, widget){
        console.log('select3-changed', options, widget);     
    });
");