yii2-extension yii2-multi-select-widget {🖫 45,034, ⚐ 4, ★ 33}

2amigos/yii2-multi-select-widget

Multiselect Bootstrap widget for Yii2.

Wednesday, February 7, 2018
by tonydspaniard
Repository
14 Watchers
33 Stars
45,034 Installations

PHP
3 Dependents
0 Suggesters
20 Forks
4 Open issues
4 Versions
6 % Grown

The README.md

, _(*1)

This library contains two of the most useful bootstrap multi-select plugins. One is the MultiSelect Bootstrap plugin from David Stutz and the other is the MultiSelect.js plugin from Loudev., _(*2)

Installation

The preferred way to install this extension is through composer., _(*3)

Either run, _(*4)

php composer.phar require 2amigos/yii2-multi-select-widget "*"

or add, _(*5)

"2amigos/yii2-multi-select-widget" : "*"

to the require section of your application's composer.json file., _(*6)

Usage for MultiSelect Bootstrap Plugin

Bootstrap multiselect plugin , _(*7)

Using a model, _(*8)

use dosamigos\multiselect\MultiSelect;

= $form->field($model, 'attribute')->widget(MultiSelect::className(),[
    'data' => ['super', 'natural'],
]) ?>

Using it as standalone widget, _(*9)

echo MultiSelect::widget([
    'id'=>"multiXX",
    "options" => ['multiple'=>"multiple"], // for the actual multiselect
    'data' => [ 0 => 'super', 2 => 'natural'], // data as array
    'value' => [ 0, 2], // if preselected
    'name' => 'multti', // name for the form
    "clientOptions" => 
        [
            "includeSelectAllOption" => true,
            'numberDisplayed' => 2
        ], 
]);

Usage for MultiSelectListBox Bootstrap Plugin

Bootstrap multiselect plugin , _(*10)

The functionality to use this plugin is actually the same as its an extension of the previous one. The only thing that changes its use is its set of configuration options., _(*11)

use dosamigos\multiselect\MultiSelectListBox;
use yii\web\JsExpression;

= $form->field($model, 'attribute')->widget(MultiSelectListBox::className(),[
    'data' => ['super', 'natural'],
    'clientOptions' => [
        'selectableHeader' => "",
        // yep, events MUST use JsExpression
        'afterInit' => new JsExpression('function(ms){ // ... }')
    ]
]) ?>

Further Information

I highly recommend you to visit both sites:, _(*12)

Then, check what are the options that would allow you to create one or the other. I have never used both on the same UI and I am not sure whether they can be used together or not. The MultiSelectListBox has a different constructor function name but very similar (multiSelect vs multiselect), but we are not sure whether they are compatible or not., _(*13)

If you have the experience and willing to share, let us know on the issues and we will update this README file accordingly., _(*14)