RequireJS & SeaJS
在 模块化开发
开发以前,都是直接在页面上引入 script
标签来引用脚本的,当项目变得比较复杂,就会带来很多问题。
- JS项目中的依赖只有通过引入JS的顺序来确定,项目会变得复杂难以维护。
- 复杂的脚本会暴露很多全局变量, 比如 $,_. ... 。
- 同步加载的时候,网页会停止渲染,加载时间越长,网页失去响应的事件就越长。
于是,AMD 规范就诞生了,AMD 即为异步模块定义,有效避免同步加载导致页面的假死现象。RequireJS 是一个 AMD 的实现,后来还有CMD规范,玉伯的 而SeaJS 是 CMD 的一个实现,两者最大的区别就是
RequireJS 是预加载,而sea.js 是懒加载,也就是按需加载
什么意思 ??
比如下面的代码
define(function(require,exports,module){
// do something
var mod1 = require('./mod1');
// do something
var mod2 = require('./mod2');
})
RequireJS 会全部找到这个模块的依赖,并在开始执行是就加载全部的依赖,
而SeaJS 则是按需加载,直到遇到 require 才会加载。
RequireJS 内部通过
Function.prototype.toString()
,然后使用正则匹配所有的require 方法,将其转化为
define(['./mod1',./mod2']function(mod1,mod2)
这种方式。
有很多关于这两种方式的争吵,由于我没有做过较大的项目,所以对于这两种方式在正真项目中使用的区别也不清楚。
回顾 RequireJS
主要接口有两个: require
& define
,define 是模块的定义方法,require 是模块的使用方法。
define 的参数为 define (id?,deps?,factory)
。第一个为模块ID,第2个为依赖列表,第三个是工厂方法 。如果不定义ID,则为匿名方法,通常情况,模块ID 等于模块在工程的路径。deps 和 factory 有约定,deps 数组有多少个元素,factory 就会有多少个形参,形参对于与依赖模块工厂函数执行后的返回值。
define ("id",["mod1","mod2"],function(mod1,mod2){
return {
///
};
})
require 方法和 define 基本一致。
文件目录
└─ use-require/
├─ app/
│ ├─ js/
│ │ ├─ module/
│ │ │ ├─ a.js
│ │ │ └─ b.js
│ │ ├─ main.js
│ └─ lib/
│ │ └─ require.js
├─ index.html
└─ readme.md
现在,需要在 index.html 引导整个程序 。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
</head>
<body>
<script src="./app/lib/require.js" data-main="./app/js/main">
</script>
</body>
</html>
引入 requirejs,并通过 data-main
申明 启动 js 文件。
注意: data-main 指向的文件所在路径就是 baseUrl,在这里就是app/js ,
baseUrl 也可以通过require.config 设置 。如果没有通过 data-main 属性指定 baseUrl ,也没有通过config的方式显示声明 baseUrl ,那么 baseUrl 默认为加载requirejs的那个页面所在的路径
下面 b 依赖 a ,那么就应该写module/a
,而 main 依赖 b ,写为module/b
,这个路径会和 baseUrl 拼接,与a ,b 所在的路径无关 。有时候,你可能需要生成一个相对于模块的URL地址。你可以将require
作为一个依赖注入进来,然后调用require.toUrl()
以生成该URL 。define(["require"], function(require) {
var url = require.toUrl("./style.js");
});
有时候你想避开"baseUrl + paths"的解析过程,而是直接指定加载某一个目录下的脚本。此时可以这样做:如果一个module ID符合下述规则之一,其ID解析会避开常规的"baseUrl + paths"配置,而是直接将其加载为一个相对于当前HTML文档的脚本:
注意是 相对于 HTML 文档,因为 js脚本是会被插入到 html 文档中执行的 。
- 以 ".js" 结束 。
- 以 "/" 开始。
- 包含 URL 协议, 如 "http:" or "https:"。
一般来说,最好还是使用baseUrl及"paths" config去设置module ID。它会给你带来额外的灵活性,如便于脚本的重命名、重定位等。 同时,为了避免凌乱的配置,最好不要使用多级嵌套的目录层次来组织代码,而是要么将所有的脚本都放置到baseUrl中,要么分置为项目库/第三方库的一个扁平结构,如下:
└─ project/
├─ js/
│ ├─ app/
│ │ └─ sub.js
│ ├─ lib/
│ │ ├─ jquery.js
│ │ └─ require.js
│ └─ app.js
├─ index.html
└─ readme.md
下面自然就顺利成章
申明模块a
define(function() {
'use strict';
return {
name: "hello , i am a"
}
})
模块 b
define(["module/a"], function(a) {
'use strict';
var aName = a.name;
var name = "hello i am b";
return {
sayHello: function() {
console.log(name + " my brother is " + aName);
}
}
})
在模块b 里面依赖模块a 。
main.js
require(["module/b"], function(b) {
'use strict';
b.sayHello();
})
看看效果
如果使用 require.config()
配置呢?
将上面的目录复制一份,命名 use-require-config
,目录结构完全一致
main.js
requirejs.config({
baseUrl: './app/js/module'
})
require([".b"], function(b) {
'use strict';
b.sayHello();
})
在这里,将配置放在 main.js 里面,等会儿会讲如果不放在它里面会又什么问题。
模块 b 依赖 于 a
define(["./a"], function(a) {
'use strict';
var aName = a.name;
var name = "hello i am b";
return {
sayHello: function() {
console.log(name + " my brother is " + aName);
}
}
})
由于将
baseUrl
设置为app/js/module
,所以这里依赖a
就可以直接写a
在这里,我使用./a
, 与直接写a
一模一样,还是使用baseUrl+ moduleName
`来寻找模块路径。
如果不将 requirejs.config
放在main中,而是另外在引入一个script 节点来放置 呢
<body>
<script src="./app/lib/require.js" data-main="./app/js/main">
</script>
<script>
requirejs.config({
baseUrl: './app/js/module'
})
</script>
</body>
在浏览器运行
发现报错了,怎么回事呢?
看它寻找 main.js 的路径
file:///E:/HFLib/module/code/use-require-config/app/js/module/main.js
是 baseUrl + main.js。 这说明,配置的 baseUrl 覆盖了为 data-main 配置的路径
也就是说,一旦使用requirejs.config 来配置 baseUrl,那么所有的路径都会以 baseUrl 为基准。
所以,data-main 应改为: ..main
,注意这里必须要使用反斜杠,正斜杠拼接总是会出现问题。
通过这样就可以解决 data-main 和 requirejs.config() 的冲突了 。
paths 和 shim 。
当模块名过长是,require.js 为我们提供了路径 paths 的方式 。
理想状况下,每个加载的脚本都是通过define()来定义的一个模块;但有些"浏览器全局变量注入"型的传统/遗留库并没有使用define()来定义它们的依赖关系,你必须为此使用shim config来指明它们的依赖关系。
这是我的文件目录
index.html
<body>
<script src="./app/lib/require.js" data-main="./app/main">
</script>
</body>
main.js
requirejs.config({
paths: {
jQuery: 'lib/jQuery'
},
shim: {
'jQuery': {
exports: '$'
}
}
})
require(['jQuery'], function($) {
'use strict';
console.log($);
})
可以看到,已经顺利注入了 jQuery 依赖。
require.js 中还有很多配置和用法,我用的就比较少,就简单介绍到这里。
下来,我要实现一个简化的模块加载器,类似于 require.js.
实现一个自己的模块加载器
太晚了 。
就在 实现一个自己的模块加载器(二)中实现一个类似 require.js 的Demo 吧 。