构建与模块

不同的 Select2 构建版本

Select2 提供了多个构建版本,适用于不同的使用环境。如果你认为你需要在非标准环境中使用 Select2(例如你正在使用 AMD),你应该阅读下面的列表。

构建名称 何时使用该构建
标准版 (select2.js / select2.min.js) 这是大多数人在使用 Select2 时应该使用的构建。它包含了最常用的特性。
完整版 (select2.full.js / select2.full.min.js) 你只有在需要包含推荐依赖项(如jquery.mousewheel

在 AMD 或 CommonJS 加载器中使用 Select2

Select2 应该可以与大多数符合 AMD 或 CommonJS 规范的模块加载器一起工作,包括RequireJSalmond。Select2 随附了一个修改过的UMD jQuery 模板的模板,支持 CommonJS 和 AMD 环境。

配置

对于大多数 AMD 和 CommonJS 设置,Select2 所用数据文件的位置将自动确定并处理,你无需做任何事情。

Select2 内部使用 AMD 和 r.js 构建工具来生成位于dist文件夹中的文件。这些文件是通过src文件夹中的文件构建而来,因此你可以直接让你的模块指向 Select2 源代码,并加载jquery.select2select2/core,当你想要使用 Select2 时。位于dist文件夹中的文件也是 AMD 兼容的,因此如果你想加载所有默认的 Select2 模块,你可以直接引用该文件。

如果你在某个构建环境中使用 Select2,而该环境中预定义的模块名称会在构建步骤中被更改,那么 Select2 可能无法找到可选的语言文件。你可以通过amdLanguageBase选项手动设置这些文件要使用的前缀。

$.fn.select2.defaults.set('amdLanguageBase', 'select2/i18n/');

amdLanguageBase

指定用于解析 Select2 语言文件的基础 AMD 加载器语言路径。通常不需要修改此选项,但在某些构建环境中模块名可能发生变化的情况下可用。

由于在旧版本的 r.js 构建工具中存在一个 bug,有时 Select2 在编译后的构建文件中会被放在 jQuery 之前。由于这个原因,Select2 将触发错误,因为它无法找到或加载 jQuery。通过升级到 r.js 构建工具 2.1.18 或更高版本,即可解决此问题。

无噪 Logo
无噪文档
25 年 6 月翻译
版本号 4.0.13
文档源↗