wdmg/yii2-selectinput

Bootstrap3 SelectInput widget for Yii2

1.0.9 2020-04-27 08:18 UTC

Requires

• bower-asset/bootstrap-selectinput-plugin: ^1.2.1
• yiisoft/yii2: ^2.0.33
• yiisoft/yii2-bootstrap: *

MIT

• Alexsander Vyshnyvetskyy
• W.D.M.Group, Ukraine

• bootstrap
• extension
• input
• yii
• widget
• select
• yii2
• wdmg

README

Yii2 SelectInput

SelectInput widget for Yii2

Requirements

• PHP 5.6 or higher
• Yii2 v.2.0.33 and newest
• Yii2 Bootstrap
• Bootstrap SelectInput

Installation

To install the widget, run the following command in the console:

$ composer require "wdmg/yii2-selectinput"

Usage

Example of standalone widget:

<?php

use wdmg\widgets\SelectInput;
...

echo SelectInput::widget([
    'model' => $model,
    'attribute' => 'type',
    'items' => [
        'value' => 'Label',
        ...
    ],
    'options' => [
        'class' => 'form-control'
    ],
    'pluginOptions' => [
        'dropdownClass' => '.dropdown',
        'listClass' => '.dropdown-menu',
        'itemClass' => '.dropdown-item',
        'toggleClass' => '.btn .btn-default .dropdown-toggle',
        'toggleText' => 'Dropdown',
        'toggleCaret' => '<span class="caret"></span>',
        'toggleChange' => true,
        'autocomplete' => false,
        'minInput' => 2
    ]
])

?>

Example of use with ActiveForm:

<?php

use wdmg\widgets\SelectInput;
...

$form = ActiveForm::begin();
...

echo $form->field($model, 'type')->widget(SelectInput::class, [
    'items' => [
        'value' => 'Label',
        ...
    ],
    'options' => [
        'class' => 'form-control'
    ],
    'pluginOptions' => [
        'dropdownClass' => '.dropdown',
        'listClass' => '.dropdown-menu',
        'itemClass' => '.dropdown-item',
        'toggleClass' => '.btn .btn-default .dropdown-toggle',
        'toggleText' => 'Dropdown',
        'toggleCaret' => '<span class="caret"></span>',
        'toggleChange' => true,
        'autocomplete' => false,
        'minInput' => 2
    ]
]);
...

ActiveForm::end();

?>

Options

SelectInput extends InputWidget so you can use any options available for this widget. In addition, you can use these custom options if necessary:

Name	Type	Default	Description
options	array	['class' => 'form-control']	Standard options for the input widget.
pluginOptions	array	['dropdownClass' => '.dropdown', 'listClass' => '.dropdown-menu', 'itemClass' => '.dropdown-item', 'toggleClass' => '.btn .btn-default .dropdown-toggle', 'toggleText' => 'Dropdown', 'toggleCaret' => '<span class="caret"></span>', 'toggleChange' => true, 'autocomplete' => false, 'minInput' => 2	Plugin SelectInput options passed to js. Read more here (https://github.com/wdmg/bootstrap-selectinput).
items	array	['value' => 'Label']	Array values with labels.

Status and version

• v.1.0.9 - Update dependencies
• v.1.0.8 - Fixed widget ID and init after Pjax reloading
• v.1.0.7 - Update pluginOptions and plugin version
• v.1.0.6 - Fixed deprecated class declaration
• v.1.0.5 - Update README.md. Update Yii2 version.