一、seajs.config配置说明:
1.base说明:
base是字符串类型,表示基础或叫做根路径(最好绝对地址)
备注:
(1)base如果不写的话是根据你引用sea.js的地址目录
(2)base如果写了’.’或者 ‘/’或者’ ’这些,会默认从服务根目录开始
(3)base如果写了’js/’之类的相对路径,会默认根据你引用sea.js的地址目录
例如:
seajs.config({
base: 'http://example.com/path/to/base/'
});
2.alias说明
例如:
seajs.config({
base: 'http://example.com/path/to/base/',
// 别名配置
alias: {
'es5-safe': 'gallery/es5-safe/0.9.3/es5-safe',
'jquery': 'jquery/jquery/1.10.1/jquery'
}
});
引入的时候:加载模块(seajs.use("es5-safe")) 引入模块 :(require("jquery"));
3.paths说明:
当目录比较深,或需要跨目录调用模块时,可以使用paths来简化书写。
例如:
seajs.config({
base:'http://example.com/path/to/base/',
//表示路径配置
paths:{
'cwd':'static/common/js'
},
alias: {
'es5-safe': 'gallery/es5-safe/0.9.3/es5-safe',
'jquery': 'jquery/jquery/1.10.1/jquery',
'jquery':'cwd/common/jquery-1.11.3'//alias中使用 static/common/js/common/jquery-1.11.3
}
})
seajs.use('cwd/project/AA');//static/common/js/project/AA
var index = require(cwd/index)// static/common/js/index.js
4.map说明:
map是Array类型,表示配置可对模块路径进行映射修改,可用于路径转换、在线调试等。
例如:
seajs.config({
map: [
//[ '.js' , '-debug.js' ]
['.js' , '.js?_t='+(new Date).getTime()]
]
});
define(function(require, exports, module) {
var a = require('./a');
//=> 加载的是 path/to/a-debug.js
});
5.preload说明:(备注该属性在V2.3版本时候去除了)
preload是Array或String类型,表示预加载项,可以在普通模块加载前,提前加载并初始化好指定模块。
备注:preload中的空字符串会被忽略掉。使用时需要等到 use 才加载
例如:
seajs.config({
preload: ["jquery"]
});
6.debugBoolean 调试使用
值为 true 时,加载器不会删除动态插入的 script 标签。插件也可以根据 debug 配置,来决策 log 等信息的输出。
seajs.config({
debug:true
});
7.vars变量配置
有些场景下,模块路径在运行时才能确定,这时可以使用vars变量来配置。
seajs.config({
vars: {
'locale': 'zh-cn'
}
});
define(function(require, exports, module) {
var lang = require('./i18n/{locale}.js');
//=> 加载的是 path/to/i18n/zh-cn.js
});
vars配置的是模块标识中的变量值,在模块标识中用{key}来表示变量。
二、 define
1.所有模块都通过 define 来定义
define(function(require, exports, module) {
(1). // 通过require.async引入依赖(引入模块);
require.async是异步加载的在引入后,的回调函数中才能使用,函数返回值就是require对象
require.async("jquery",fun) 异步加载模块 jquery(别名) fun回调函数(可选参数)
require.async(['lib/common/common.js','lib/common/index.js'],function(){
Echo.init({
offset: 150, //离可视区域多少像素的图片可以被加载
throttle: 10 //图片延迟多少毫秒加载
});
}); //调用多个模块 fun回调函数可选()
(2).require引入依赖(引入模块);
Require引入就可以使用
var Spinning = require('lib/common/common.js'); 基础地址/lib/common/common.js
Spinning.tostring(); 调用Spinning里面的tostring方法
require直接引入整个文件
require.async(["swiper"], function() {
require('module/Mycenter/mycenter');
})
2.对外暴露接口
// 通过exports对外提供接口
exports.tonumber = function(){ var a = 0;}
// 或者通过module.exports提供整个接口 (推荐使用)
module.exports.tonumber = function(){ var a = 0;}
});
三 、use()
seajs.use 用来在页面中加载模块。通过 use 方法,可以在页面中加载任意模块。use 的模块路径相对于当前页面
语法:seajs.use(id, callback?)
// 加载模块 main,并在加载完成时,执行指定回调
seajs.use(‘./main’)加载模块
seajs.use(‘./main’, function(main) {
main.init();
});
use 方法还可以一次加载多个模块:
// 并发加载模块 a 和模块 b,并在都加载完成时,执行指定回调
seajs.use(['./a', './b'], function(a, b) { 加载多个模块 fun回调函数(可选参数);
a.init();
b.init();
});
四、注意
引入 sea.js 时,可以把 sea.js 与其他文件打包在一起,可提前合并好,或利用 combo 服务动态合并。无论哪一种方式,为了让 sea.js内部能快速获取到自身路径,推荐手动加上 id 属性: