README

这是一个 Select2 小部件，也是 Yii 2 对 Select2 jQuery 插件 的增强包装。这个基于 jQuery 的输入小部件是 select 框的替代品。它支持搜索、远程数据集和结果的无限滚动。小部件专门为 Bootstrap 3 设计，并提供了源插件中不可用的几个增强功能。如果浏览器不支持 jQuery，小部件可以优雅地降级到正常的 HTML select 或文本输入。

注意：此扩展是 yii2-widgets 的子仓库分离出来的。从 2014 年 11 月 8 日起进行分离，以便开发者在需要时可以单独安装此特定小部件。也可以使用扩展的先前方式，使用 yii2-widgets 的整个套件。

安装

安装此扩展的首选方式是通过 composer。检查此扩展的 composer.json 以获取此扩展的要求和依赖项。阅读此 web 提示 /wiki 了解如何为应用程序的 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.9。有关详细信息，请参阅 更改日志。

小部件在 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 文件。