2017 © Pedro Peláez
 

yii2-extension yii2-chosen

Bootstrap Chosen widget for Yii2

image

nex/yii2-chosen

Bootstrap Chosen widget for Yii2

  • Sunday, January 28, 2018
  • by RomeroMsk
  • Repository
  • 4 Watchers
  • 23 Stars
  • 18,681 Installations
  • PHP
  • 3 Dependents
  • 0 Suggesters
  • 13 Forks
  • 0 Open issues
  • 2 Versions
  • 7 % Grown

The README.md

Chosen + Bootstrap 3 + Yii2

Credits

Chosen http://harvesthq.github.io/chosen/, (*1)

Chosen Bootstrap Look & Feel https://github.com/dbtek/chosen-bootstrap (with my style fixes), (*2)

Installation

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

Either run, (*4)

php composer.phar require "nex/yii2-chosen" "*"

or add, (*5)

"nex/yii2-chosen" : "*"

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

Usage

With a model, (*7)



= Chosen::widget([
    'model' => $model,
    'attribute' => 'selectable_attr',
    'items' => [1 => 'First item', 2 => 'Second item', 3 => 'Third item'],
    'multiple' => true,
]);?>

= $form->field($model, 'selectable_attr')->widget(
    Chosen::className(), [
        'items' => [1 => 'First item', 2 => 'Second item', 3 => 'Third item'],
        'disableSearch' => 5, // Search input will be disabled while there are fewer than 5 items
        'clientOptions' => [
            'search_contains' => true,
            'single_backstroke_delete' => false,
        ],
]);?>

Without a model, (*8)

<?php
use nex\chosen\Chosen;
?>
<?= Chosen::widget([
    'name' => 'ChosenTest',
    'value' => 3,
    'items' => [1 => 'First item', 2 => 'Second item', 3 => 'Third item'],
    'allowDeselect' => false,
    'disableSearch' => true, // Search input will be disabled
    'clientOptions' => [
        'search_contains' => true,
        'max_selected_options' => 2,
    ],
]);?>

To override default placeholder strings you can add translated messages for Select an option (single select) and Select some options (multiple select) to your application message file. By default widget will use 'app' category to translate this strings, but you can set your own category by changing translateCategory option in widget configuration. For example, you can write this in application config file:, (*9)

<?php
\Yii::$container->set('nex\chosen\Chosen', [
    'translateCategory' => 'my-app',
]);

Also you can override placeholder text when invoking widget (it can be useful for selects with small width):, (*10)


= Chosen::widget([
    'name' => 'ChosenTest',
    'value' => 3,
    'items' => [1 => 'First item', 2 => 'Second item', 3 => 'Third item'],

    'placeholder' => 'Select',
]);?>

The Versions

28/01 2018

dev-master

9999999-dev https://github.com/RomeroMsk/yii2-chosen

Bootstrap Chosen widget for Yii2

  Sources   Download

BSD-3-Clause BSD 3-Clause

The Requires

 

extension yii2 bootstrap widget bootstrap 3 chosen

07/06 2016

v1.0

1.0.0.0 https://github.com/RomeroMsk/yii2-chosen

Bootstrap Chosen widget for Yii2

  Sources   Download

BSD 3-Clause

The Requires

 

extension yii2 bootstrap widget bootstrap 3 chosen