SeaJS 是一个适用于 Web 浏览器端的模块加载器。使用 SeaJS,可以更好地组织 JavaScript 代码。
SeaJS 具有核心特性:
SeaJS 兼容所有 PC 和 Mobile 端的主流浏览器:
IE 5.5+ ✔ Chrome 3+ ✔ Firefox 2+ ✔ Safari 3.2+ ✔ Opera 10+ ✔
要在项目中使用SeaJS,你所有需要做的准备工作就是下载sea.js然后放到你项目的某个位置。
SeaJS项目目前托管在GitHub上,主页为 https://github.com/seajs/seajs/ 。可以到其git库的build目录下下载sea.js(已压缩)或sea-debug.js(未压缩)。
下载完成后放到项目的相应位置,然后在页面中通过<script>
标签引入,你就可以使用SeaJS了。
使用SeaJS开发JavaScript的基本原则就是:一切皆为模块。引入SeaJS后,编写JavaScript代码就变成了编写一个又一个模块,SeaJS中模块的概念有点类似于面向对象中的类——模块可以拥有数据和方法,数据和方法可以定义为公共或私有,公共数据和方法可以供别的模块调用。
另外,每个模块应该都定义在一个单独js文件中,即一个对应一个模块。
下面介绍模块的编写和调用。
<script src="sea.js"></script>
<script>
seajs.use("main");
</script>
用script标签引入 sea.js,然后用seajs.use进行配置。
seajs.use主要用于载入入口模块。入口模块相当于C程序的main函数,同时也是整个模块依赖树的根。上面在TinyApp小例子中,init就是入口模块。seajs.use用法如下:
//单一模式
seajs.use('./a');
//回调模式
seajs.use('./a', function(a) {
a.run();
});
//多模块模式
seajs.use(['./a', './b'], function(a, b) {
a.run();
b.run();
});
一般seajs.use只用在页面载入入口模块,SeaJS会顺着入口模块解析所有依赖模块并将它们加载。
如果入口模块只有一个,也可以通过给引入sea.js的script标签加入”data-main”属性来省略seajs.use,例如上面的代码也可以改为如下写法:
<script src="sea.js" data-main="main.js"></script>
不过我一直没有成功过,具体原因不明。
seajs.config seajs.config(options)
用来进行配置的方法。
seajs.config({
// 别名配置
alias: {
‘es5-safe’: ‘gallery/es5-safe/0.9.3/es5-safe’,
‘json’: ‘gallery/json/1.0.2/json’,
‘jquery’: ‘jquery/jquery/1.10.1/jquery’
},
// 路径配置
paths: {
‘gallery’: ‘https://a.alipayobjects.com/gallery’
},
// 变量配置
vars: {
‘locale’: ‘zh-cn’
},
// 映射配置
map: [
[‘http://example.com/js/app/‘, ‘http://localhost/js/app/‘]
],
// 预加载项
preload: [
Function.prototype.bind ? ” : ‘es5-safe’,
this.JSON ? ” : ‘json’
],
// 调试模式
debug: true,
// Sea.js 的基础路径
base: ‘http://example.com/path/to/base/‘,
// 文件编码
charset: ‘utf-8’
});
支持以下配置选项:
alias Object
当模块标识很长时,可以使用 alias 来简化。
seajs.config({
alias: {
‘jquery’: ‘jquery/jquery/1.10.1/jquery’,
‘app/biz’: ‘http://path/to/app/biz.js‘,
}
});
define(function(require, exports, module) {
var $ = require(‘jquery’);
//=> 加载的是 http://path/to/base/jquery/jquery/1.10.1/jquery.js
var biz = require(‘app/biz’);
//=> 加载的是 http://path/to/app/biz.js
});
使用 alias,可以让文件的真实路径与调用标识分开,有利于统一维护。
paths Object
当目录比较深,或需要跨目录调用模块时,可以使用 paths 来简化书写。
seajs.config({
paths: {
‘gallery’: ‘https://a.alipayobjects.com/gallery‘,
‘app’: ‘path/to/app’,
}
});
define(function(require, exports, module) {
var underscore = require(‘gallery/underscore’);
//=> 加载的是 https://a.alipayobjects.com/gallery/underscore.js
var biz = require(‘app/biz’);
//=> 加载的是 path/to/app/biz.js
});
paths 配置可以结合 alias 配置一起使用,让模块引用非常方便。
vars Object
有些场景下,模块路径在运行时才能确定,这时可以使用 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} 来表示变量。
map Array
该配置可对模块路径进行映射修改,可用于路径转换、在线调试等。
seajs.config({
map: [
[ ‘.js’, ‘-debug.js’ ]
]
});
define(function(require, exports, module) {
var a = require(‘./a’);
//=> 加载的是 path/to/a-debug.js
});
更多用法可参考:调试实践
preload Array
使用 preload 配置项,可以在普通模块加载前,提前加载并初始化好指定模块。
// 在老浏览器中,提前加载好 ES5 和 json 模块
seajs.config({
preload: [
Function.prototype.bind ? ” : ‘es5-safe’,
this.JSON ? ” : ‘json’
]
});
preload 中的空字符串会被忽略掉。
注意:preload 中的配置,需要等到 use 时才加载。比如:
seajs.config({
preload: ‘a’
});
// 在加载 b 之前,会确保模块 a 已经加载并执行好
seajs.use(‘./b’);
preload 配置不能放在模块文件里面:
seajs.config({
preload: ‘a’
});
define(function(require, exports) {
// 此处执行时,不能保证模块 a 已经加载并执行好
});
debug Boolean
值为 true 时,加载器不会删除动态插入的 script 标签。插件也可以根据 debug 配置,来决策 log 等信息的输出。
base String
Sea.js 在解析顶级标识时,会相对 base 路径来解析。详情请参阅 模块标识
注意:一般请不要配置 base 路径,把 sea.js 放在合适的路径往往更简单一致。
charset String | Function
获取模块文件时,
SeaJS中使用“define”函数定义一个模块。define可以接收三个参数:
复制代码 代码如下:
上面是我从SeaJS源码中摘录出来的,define可以接收的参数分别是模块ID,依赖模块数组及工厂函数。
define对于不同参数个数的解析规则如下:
如果只有一个参数,则赋值给factory。
如果有两个参数,第二个赋值给factory;第一个如果是array则赋值给deps,否则赋值给id。
如果有三个参数,则分别赋值给id,deps和factory。
但是,包括SeaJS的官方示例在内几乎所有用到define的地方都只传递一个工厂函数进去,类似与如下代码:
复制代码 代码如下:
define(function(require, exports, module) {
//code of the module…
});
个人建议遵循SeaJS官方示例的标准,用一个参数的define定义模块。那么id和deps会怎么处理呢?
id是一个模块的标识字符串,define只有一个参数时,id会被默认赋值为此js文件的绝对路径。如example.com下的a.js文件中使用define定义模块,则这个模块的ID会赋值为 http://example.com/a.js ,没有特别的必要建议不要传入id。deps一般也不需要传入,需要用到的模块用require加载即可。
工厂函数是模块的主体和重点。在只传递一个参数给define时(推荐写法),这个参数就是工厂函数,此时工厂函数的三个参数分别是:
1.require——模块加载函数,用于记载依赖模块。
2.exports——接口点,将数据或方法定义在其上则将其暴露给外部调用。
3.module——模块的元数据。
这三个参数可以根据需要选择是否需要显示指定。
下面说一下module。module是一个对象,存储了模块的元信息,具体如下:
1.module.id——模块的ID。
2.module.dependencies——一个数组,存储了此模块依赖的所有模块的ID列表。
3.module.exports——与exports指向同一个对象。
三种编写模块的模式
第一种定义模块的模式是基于exports的模式:
复制代码 代码如下:
define(function(require, exports, module) {
var a = require('a'); //引入a模块
var b = require('b'); //引入b模块
var data1 = 1; //私有数据
var func1 = function() { //私有方法
return a.run(data1);
}
exports.data2 = 2; //公共数据
exports.func2 = function() { //公共方法
return 'hello';
}
});
复制代码 代码如下:
define(function(require) {
var a = require(‘a’); //引入a模块
var b = require(‘b’); //引入b模块
var data1 = 1; //私有数据 var func1 = function() { //私有方法 return a.run(data1); } return { data2: 2, func2: function() { return 'hello'; } };
});
如果模块定义没有其它代码,只返回一个对象,还可以有如下简化写法:
复制代码 代码如下:
define({
data: 1,
func: function() {
return ‘hello’;
}
});
第三种方法对于定义纯JSON数据的模块非常合适。
helloworld.html源码如下:
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>Hello Sea.js</title>
</head>
<body>
<script src="sea.js"></script>
<script>
seajs.use("main");
</script>
</body>
</html>
main.js源代码如下:
define(
"main", //可以不要
[], //可以不要
function test() {
alert("Hello world!");
}
);
Seajs相关知识
seajs.Use 引入入口文件
第一个参数表示模块id
字符串表示一个模块id
数组,数组每个成员表示一个模块
第二个参数表示回调函数(可有可无的)
作用就是当模块加载完成执行回调函数
作用域是全局作用域
参数与前面加载的模块是一致的
Use方法返回值是seajs对象,因此可以链式调用
Seajs默认根目录是seajs文件所在的目录,因此我们通常要将seajs文件放在最外面
文件只需要引入seajs文件,其他的是要通过seajs引入的
通常来说入口文件只有一个,所以链式调用时候,很少见,在一个use方法回调函数内部不能知道其他use方法什么时候加载完毕
Define 定义模块的,根据传递的参数我们分成三类
第一类 传递一个参数
如果是一个值类型的数据,那么这个数据直接作为接口暴漏出来
如果是一个对象,那么这个对象就是暴漏的接口
如果是一个函数(最常见的一种方式,它符合commonjs规范),
作用域是全局作用域
参数有三个
Require 加载模块的
Exports 定义接口的
Module 模块的对象
第二类 传递两个参数
第一个参数
如果是字符串 表示模块的id
如果是数组 表示模块的依赖集合
此时不论模块有没有使用该模块都会去加载它,并且不会去解析模块内部require方法
第二个参数表示模块函数(对象等其他数据)这个函数的使用方式跟上面函数式一致的
第三类 传递三个参数
第一个参数 是字符串,表示模块id
第二个参数 是数组,表示依赖集合
第三个参数 函数(其他数据),模块函数,函数的使用方式跟上面的函数式一致
通常来说一个文件只能添加一个模块(模块没有定义id),如果定义了多个模块,后面的覆盖前面的
如果模块定义了id,此时这些模块是兼容的,引用这些模块的时候,一定要通过这些id引用
Require加载模块
1 不能简写,在模块函数的参数中
2 不能修改
不能赋值
不能定义变量
不能作为函数参数
在子函数中不能修改
3 使用时不能使用表达式
当我们定义模块id时候,此时我们不能直接引入该模块
想使用模块要分成两步
第一步 在依赖模块集合中引入该模块
第二步 在模块内部用require引入模块id
接口exports 包含commonjs规范定义接口的语法
1 exports.接口
可以继续添加接口
2 module.exports.接口
可以继续添加接口,并且1和2是可以混用的
3 module.exports = {}
定义全部的接口,不能在使用前面两种定义接口方式
4 return {}
定义全部的接口,此时会将前面所有接口覆盖掉
5 return function () {}
定义接口函数,使用时候,必须调用它
6 module.exports = function () {}
定义接口函数
7 define(值类型)
定义一个值类型的数据接口
8 module.exports = 值类型
定义一个值类型的数据接口
9 return 值类型
定义一个值类型的数据接口
10 define({})
定义一个对象接口
注意
定义接口的优先级
Return > module.exports = {}或者function > module.exports.接口 或者exports.接口
Exports绝对不能赋值对象 exports = {}
定义接口函数时候,有两种方式
第一种
Return function 或者module.exports = function
第二种
Var demo = function () {}或者function demo (){}
Return demo 或者module.exports = demo
模块module
Id 表示模块的id,如果定义模块没有添加id的时候,模块的id就是uri
Uri表示模块所在文件的地址
Exports表示模块暴漏的接口
Status 模块的状态
Dependencies 依赖的模块,是一个数组 每个成员表示一个模块的id
Deps 依赖的模块,是个对象,对象属性表示模块的id,对象属性值表示模块的信息对象
异步加载模块 require.async
与use方法很像,只不过一个在模块外部使用,一个在模块内部使用
与require的区别,require遵守commonjs规范是同步加载的,require.async是异步加载的
Require引入就可以使用
Require.async 在引入后,的回调函数中才能使用,函数返回值就是require对象
在if语句中
如果条件成立
Require会加载并执行该模块
Require.async 会一步加载模块,并执行
如果条件不成立
Require会加载模块,但不会执行
Require.async 不会加载模块,也不会执行
在异步操作中
例如在定时器中
Require会立即加载文件,但是等到定时器执行的时候才会执行模块函数
Require.async 会等到异步操作执行的时候,加载并执行模块
配置config
配置是seajs为我们提供的功能,但是我们想使用就要配置这些信息
Alias 创建模块的别名
作用简化对模块的引用
值是一个对象
对象的属性名称表示别名
对象的属性值表示真实路径
Path 定义路径
作用 简化对模块路径书写
值是一个对象
Key表示简化的路径
Value表示真实的路径
Map 定义模块映射关系的
批处理模块的
值是一个二维数组
数组的每个成员表示一组映射规则,每个映射规则是一个数组
第一个成员表示匹配的规则
第二个成员表示处理的规则
Debug 进入调试模块,可以看到js加载过程
Vars 定义路径模板变量
作用可以是引入的模块动态会
模板语法 {}, 在路径的{}中我们可以使用vars中定义的变量
值是一个对象
Key 表示变量
Value表示变量的值
Charset 定义js文件加载时候的编码格式,
Base 定义模块的根路径,它的值是个字符串,此时根路径就是个字符串指向的目录,此时seajs文件可以随意的防止了
Seajs插件
我们需要的功能,seajs没有帮我们实现,别人帮我们了,我们使用别人提供的代码,这些代码就是插件,我们使用这些插件就要去加载这些插件文件
在seajs中使用插件,一定要写在seajs标签后面(插件依赖于seajs),对于一些插件是需要写配置的,例如预加载插件
预加载插件
在模块加载过程中有限加载某些文件(通常这些文件都是一些代码工具库,或者框架)
这些文件的特征是,都会提供一个全局变量方便我们使用它
这个插件的作用
1 我们不用在每一个模块内显性的引入它,而可以直接使用他们(因为他们提供了全局变量)
2 我们不需要修改这些文件的源代码,因为他们提供全局变量
3 在更新代码库的时候成本低,我们只需要更改配置就可以了,因为每个版本提供的全局变量的,
预加载插件加载时间(让我们知道,我们什么时候可以使用这些预加载的库)
在调用use方法之后,模块加载之前开始加载这些库的
所以配置项要写在use方法之前(所有的配置都要写在use方法之前,或者整个项目的最前面)
在配置中,我们通过preload属性加载库
Preload是一个数组,每一个成员代编一个文件
1 |
Css插件
到目前为止,我们学的加载文件都是加载的js文件,有时我们在工作中开发项目时候,我们写的不仅仅是js,还有css,此时如果对于一个搜索框,我们通常将他们的js与css写在一起,此时如果js是一个模块化开发文件,我们通常需要将css引入进来,这样就会是css与js产生依赖。使他们形成一个整体
使用css插件就要加载seajs-css文件
使用方式:
第一步在seajs标签后面引入该文件标签
第二步,哪个js模块需要什么css文件就通过require引入它
注意引入的css文件一定要加上.css后缀名
Use方法不仅仅可以引入js文件,还可以引入css文件,所以对于一些在渲染之前就要加载的css文件我们可以写在这里。