README

这是Select2小部件，也是为Select2 jQuery插件提供的Yii 2增强型包装器。该输入小部件是基于jQuery的select框替代品。它支持搜索、远程数据集和结果的无穷滚动。小部件特别针对Bootstrap 3进行样式设计，并提供了一些在源插件中不可用的增强功能。如果浏览器不支持jQuery，小部件将优雅地降级为正常的HTML选择或文本输入。

注意：此扩展是自2014年11月8日起从yii2-widgets分出的子仓库。分出是为了让开发者能够在需要时单独安装此特定小部件。也可以以之前的方式使用此扩展，与yii2-widgets整套工具一起使用。

安装

安装此扩展的首选方式是通过composer。检查composer.json以获取此扩展的需求和依赖项。阅读此网络提示/维基以了解如何设置应用程序的composer.json中的minimum-stability设置。

要安装，可以运行

$ php composer.phar require kartik-v/yii2-widget-select2 "@dev"

或添加

"kartik-v/yii2-widget-select2": "@dev"

到您的composer.json文件的require部分。

最新版本

注意：模块的最新版本是v2.0.8。有关详细信息，请参阅变更日志。

小部件自v2.0版本进行了重大版本更新。此版本包括对Select2插件v4.0的更新。Select2 v4.0是对Select2 v3.x的重大重写，因此预计会有许多增强或更改。要使用较早的插件版本v3.5.2，您必须将其指向小部件的v1.0.1版本。

v2.0版本的增强

• 新的theme属性，允许您在Select2中设置主题以样式化小部件。
• 由Krajee提供的全新主题Select2::THEME_KRAJEE特别为Select2进行了样式设计。这将帮助实现各种新的yii2-widget-select2功能。此主题与Bootstrap 3样式相匹配，并进行了增强。
• 还提供了其他主题，包括Select2::THEME_DEFAULT、Select2::THEME_CLASSIC和Select2::THEME_BOOTSTRAP。可以添加自定义主题并配置小部件。
• 不再需要query插件属性。即使没有设置tags、query或ajax，也不必强制配置data。小部件将智能评估属性和默认列表值。
• 增强的标记支持。就像多选一样使用它，但有标记值。此外，还可以动态创建标签。
• 增强的Ajax支持。有关详细信息，请参阅演示。
• Select2 3.5.x插件的initSelection方法已弃用/删除。Select2小部件提供了新的initValueText属性来满足这一需求（例如，用于基于Ajax的加载）。
• 能够在Select2下拉中禁用可选值或在可选值中添加HTML属性。
• 通过Krajee增强，禁用搜索框以使其像普通选择框一样使用。
• 对地域和翻译的增强。允许同一页面上有多个语言Select2小部件。

文档和演示

您可以在使用扩展的详细说明和演示中参考文档和演示。

使用方法

use kartik\select2\Select2;

// Normal select with ActiveForm & model
echo $form->field($model, 'state_1')->widget(Select2::classname(), [
    'data' => $data,
    'language' => 'de',
    'options' => ['placeholder' => 'Select a state ...'],
    'pluginOptions' => [
        'allowClear' => true
    ],
]);

// Multiple select without model
echo Select2::widget([
    'name' => 'state_2',
    'value' => '',
    'data' => $data,
    'options' => ['multiple' => true, 'placeholder' => 'Select states ...']
]);

许可证

yii2-widget-select2是在BSD 3-Clause许可证下发布的。有关详情，请参阅捆绑的LICENSE.md文件。