为 Yii Framework 2 的 select2 小部件

0.1 2024-09-29 14:23 UTC

This package is auto-updated.

Last update: 2024-09-29 14:38:16 UTC


README

Yii2 框架的 Select2 小部件


php-version PHPUnit PHPUnit Codecov Infection

安装

安装此扩展的首选方式是通过 composer

运行

composer require --prefer-dist yii2-extensions/select2:^0.1

或在您的 composer.json 文件的 require 部分添加

"yii2-extensions/select2": "^0.1"

使用

下拉列表

use Yii2\Extension\Select2\Select2;

<?= $form->field($model, 'user_id')->widget(Select2::className(), [
        'items' => ArrayHelper::map(User::find()->all(), 'id', function($model) {
            return $model->username . " <{$model->email}>";
        }),
        'clientOptions' => [
            'placeholder' => 'User',
            'allowClear' => true,
        ],
        'clientEvents' => [
            'change'=>'function (e) {
                console.log("Select2 change.");
            }',
        ],
    ]) ?>

多选模式(又称标签模式)输入

use Yii2\Extension\Select2\Select2;

<?= Select2::widget([
        'name' => 'InputName',
        'items' => ArrayHelper::map(User::find()->all(), 'id', function($model) {
            return $model->fio . " <{$model->email}>";
        }),
        'options' => [ 
            'multiple' => true,
        ]
        'clientOptions' => [
            'placeholder' => 'User',
            'allowClear' => true,
        ]
    ]) ?>

小部件属性

更多详细信息请参阅: https://github.com/select2/select2

特别感谢

此代码最初由 yii2-cms 的贡献者开发,并托管在 repo: https://github.com/yii-cms/yii2-select2。我们感谢他们所有人。为了连续性和维护,我们已经将副本移动到这里。

高质量代码

static-analysis phpstan-level StyleCI

支持的 Yii2 版本

Yii20 Yii22

测试

查看文档测试部分 了解有关测试的信息。

我们的社交媒体

Twitter

许可证

MIT 许可证。请参阅 许可证文件 了解更多信息。