Select2 提供了多个构建版本,适用于不同的使用环境。如果你认为你需要在非标准环境中使用 Select2(例如你正在使用 AMD),你应该阅读下面的列表。
构建名称 | 何时使用该构建 |
---|---|
标准版 (select2.js / select2.min.js )
|
这是大多数人在使用 Select2 时应该使用的构建。它包含了最常用的特性。 |
完整版 (select2.full.js / select2.full.min.js )
|
你只有在需要包含推荐依赖项(如jquery.mousewheel |
Select2 应该可以与大多数符合 AMD 或 CommonJS 规范的模块加载器一起工作,包括RequireJS和almond。Select2 随附了一个修改过的UMD jQuery 模板的模板,支持 CommonJS 和 AMD 环境。
对于大多数 AMD 和 CommonJS 设置,Select2 所用数据文件的位置将自动确定并处理,你无需做任何事情。
Select2 内部使用 AMD 和 r.js 构建工具来生成位于dist
文件夹中的文件。这些文件是通过src
文件夹中的文件构建而来,因此你可以直接让你的模块指向 Select2 源代码,并加载jquery.select2
或select2/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 或更高版本,即可解决此问题。