Skip to content

wdmg/yii2-selectinput

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 

Yii2 Downloads Packagist Version Progress GitHub license

Yii2 SelectInput

SelectInput widget for Yii2

Requirements

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.

About

SelectInput widget for Yii2

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages