README

yii2-widget-select2

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

注意：此扩展是 yii2-widgets 的子仓库分离。自 2014 年 11 月 8 日起进行分离，以便开发人员在需要时可以独立安装此特定小部件。也可以像以前一样使用整个套件中的扩展 yii2-widgets。

安装

安装此扩展的首选方法是使用 composer。检查此扩展的 composer.json 以了解此扩展的要求和依赖关系。阅读此网络提示/wiki 了解如何设置您的应用程序 composer.json 的 minimum-stability 设置。

要安装，请运行

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

或将以下内容添加到您的 composer.json 文件的 require 部分中。

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

发布更改

注意：有关各种版本更改的详细信息，请参阅变更日志。

该小部件在 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 ...']
]);