转: seajs手册与文档之 -- 配置选项

时间:2022-01-30 08:14:03

config

可以使用 config 方法来配置seajs。

seajs.config({
alias: { //~~~类似requirejs的paths
'es5-safe': 'es5-safe/0.9.2/es5-safe',
'json': 'json/1.0.1/json',
'jquery': 'jquery/1.7.1/jquery'
},
preload: [
Function.prototype.bind ? '' : 'es5-safe',
this.JSON ? '' : 'json'
],
debug: true,
map: [
['http://example.com/js/app/', 'http://localhost/js/app/']
],
base: 'http://example.com/path/to/libs/', //~~~类似requirejs的baseUrl
charset: 'utf-8',
timeout: 20000
});

支持以下配置选项:

alias

当模块标识很长时,可以使用 alias 配置来简化。~~~设置路径别名

seajs.config({
alias: {
'app': 'http://path/to/app',
'jquery': 'jquery/1.7.1/jquery'
}
});

a.js:

define(function(require, exports, module) {
var $ = require('jquery');
//=> http://path/to/libs/jquery/1.7.1/jquery.js var biz = require('app/biz');
//=> http://path/to/app/biz.js
});

解析某个模块标识时,如果不想解析别名,可以在标识前面添加一个井号(#):

define(function(require, exports, module) {
var $ = require('#jquery');
//=> http://path/to/libs/jquery.js
});

preload

使用 preload 配置项,可以在普通模块加载前,提前加载并初始化好特定模块。

// 在老浏览器中,提前加载好 ES5 和 json 模块:
seajs.config({
preload: [
Function.prototype.bind ? '' : 'es5-safe',
this.JSON ? '' : 'json'
]
});

preload 中的空字符串会被忽略掉。

debug

值为 true 时,加载器会使用 console.log 输出所有警告和错误。 默认为 false, 加载器只抛出异常。

另外,还可以将 debug 值设为 2 . 这种情况下, 每个脚本请求都会加上唯一时间戳。这在测试期间很有用,可以强制浏览器每次都请求最新版本。

map

该配置可将某个文件映射到另一个。可用于在线调试,非常方便。更多信息,请参考 映射插件

base

SeaJS 在解析*标识时,会相对 base 路径来解析。详情请参阅 *标识

** 注意:请不要配置 base 路径,除非加载器无法自动获取。详情请参考 加载方式

charset

获取模块文件时,<script> 标签的 charset 属性。 默认是 utf-8

timeout

加载器等待脚本加载的最长时间。单位为毫秒,默认值是 20000(20秒)。

noConflict

为了避免冲突,或者需要定制全局命名空间以符合自己的口味时,可以使用 noConflict 方法来实现。 ~~~类似jquery.noConflict

var myLoader = seajs.noConflict();
myLoader.use('./main'); /* main.js */
define(function(require, exports, module) {
// snip...
});

还可以通过给该方法传递 true,来释放 define 方法。 很少会有这么做的必要, 请三思而后行。

var myLoader = seajs.noConflict(true);
myLoader.use('./main'); /* main.js */
myLoader.define(function(require, exports, module) {
// snip...
});