[转]seajs详解
[转]seajs详解
SeaJS
是一个遵循commonJS规范的javascript模块加载框架,可以实现javascript的模块化开发和模块化加载(kk:模块可按需加载或全部加载)。
SeaJS
可以和 jQuery
完美集成,使用SeaJS
可提高javascript的可读性和清晰度,解决javascript编程中繁杂的依赖关系(kk:大项目中js的数量众多和依赖关系复杂比较明显)
SeaJS
的作者是淘宝前端工程师玉伯。
SeaJS
本身遵循 KISS(Keep It Simple, Stupid)
理念进行开发,其本身仅有个位数的API,因此学习起来毫无压力。在学习SeaJS
的过程中,处处能感受到KISS原则的精髓——仅做一件事,做好一件事。
本文首先通过一个例子直观对比传统JavaScript编程和使用SeaJS
的模块化JavaScript编程,然后详细讨论SeaJS
的使用方法,最后给出一些与SeaJS
相关的资料。
假设我们现在正在开发一个Web应用TinyApp,我们决定在TinyApp中使用jQuery框架。TinyApp的首页会用到 module1.js
,module1.js
依赖module2.js
和module3.js
,同时 module3.js
依赖 module4.js
。
场景示例
传统开发
使用传统的开发方法,各个js文件代码如下:
# module1.js:
var module1 = {
run: function(){
return $.merge(['module1'], module2.run(), module3.run());
}
}
# module2.js:
var module2 = {
run : function(){
return ['module2'];
}
}
# module3.js:
var module3 = {
run: function(){
return $.merge(['module3'], module4.run() );
}
}
# module4.js:
var module4 = {
run: function(){
return ['module4'];
}
}
此时index.html需要引用module1.js及其所有下层依赖(注意顺序):
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>my tinyapp</title>
</head>
<body>
<p class="content"></p>
<script type="text/javascript" src="./js/jquery-min.js"></script>
<script type="text/javascript" src="./js/module4.js"></script>
<script type="text/javascript" src="./js/module2.js"></script>
<script type="text/javascript" src="./js/module3.js"></script>
<script type="text/javascript" src="./js/module1.js"></script>
<script>
$('.content').html(module1.run().join());
</script>
</body>
</html>
随着项目的进行,js文件会越来越多,依赖关系也会越来越复杂,使得js代码和html里的script列表往往变得难以维护。
SeaJS模块化开发
下面看看如何使用SeaJS实现相同的功能。
首先是index.html:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>my tinyapp</title>
</head>
<body>
<p class="content"></p>
<script type="text/javascript" src="./sea.js"></script>
<script>
// './init'=='./init.js'后缀可省略;
// 参数init为 init.js的外部接口 即: exports属性
seajs.use('./init', function(init) {
init.initPage();
});
</script>
</body>
</html>
可以看到html页面不再需要引入所有依赖的js文件,而只是引入一个sea.js,sea.js会处理所有依赖,加载相应的js文件,加载策略可以选择在渲染页面时一次性加载所有js文件,也可以按需加载(用到时才加载所需的js),具体加载策略使用方法下文讨论。
index.html 加载了init模块,并使用此模块的initPage方法初始化页面数据,这里先不讨论代码细节。
下面看一下模块化后JavaScript的写法:
//init.js:
define(function (require, exports, module) {
var $ = require('jquery'); // jquery.js 省略后缀?
var m1 = require('m1.js');
//jquery1.6 $.merge只支持2个参数的情况,这里扩展一下
__merge = $.merge;
$.merge = function (first, second) {
// param: array or fake array
var argArr = Array.prototype.slice.call(arguments);
return myreduce(argArr, __merge);
};
// $.merge(['dd'],['ee'],['ff'],['gg']);
function myreduce(arr, fn) {
var start = 0;
if (arguments.length === 2) {
result = arr[0];
start = 1;
} else {
result = arguments[2];
}
arr.forEach(function (item, i) {
if (i >= start) {
result = fn(result, arr[i]);
}
});
return result;
}
exports.initPage = function () {
$('.content').html(m1.run().join());
}
});
//m1.js:
define(function (require, exports, module) {
var $ = require('jquery');
var m2 = require('m2');
var m3 = require('m3');
exports.run = function () {
return $.merge(['module1'], m2.run(), m3.run());
};
});
//m2.js:
define(function (require, exports, module) {
exports.run = function () {
return ['module2'];
}
});
//m3.js:
define(function (require, exports, module) {
var $ = require('jquery');
var m4 = require('m4');
exports.run = function () {
return $.merge(['module3'], m4.run());
};
});
//m4.js:
define(function (require, exports, module) {
exports.run = function () {
return ['module4'];
};
});
乍看之下代码似乎变多变复杂了,这是因为这个例子太简单,如果是大型项目,SeaJS代码的优势就会显现出来。不过从这里我们还是能窥探到一些SeaJS的特性:
- html页面不用再维护冗长的script标签列表,只要引入一个sea.js即可。
- js代码以模块进行组织,各个模块通过require引入自己依赖的模块,代码清晰明了。
通过这个例子朋友们应该对SeaJS有了一个直观的印象,下面本文具体讨论SeaJS的使用。
SeaJS 使用教程
下载及安装
npm i seajs --save
# 页面中引入
<script src="sea.js"></script>
SeaJS基本开发原则
在讨论SeaJS的具体使用前,先介绍一下SeaJS的模块化理念和开发原则。
使用SeaJS开发JavaScript的基本原则就是:一切皆为模块。引入SeaJS后,编写JavaScript代码就变成了编写一个又一个模块。
SeaJS中模块的概念有点类似于面向对象中的类 , 模块可以拥有数据和方法,数据和方法可以定义为公共或私有,公共数据和方法可以供别的模块调用。
另外,每个模块应该都定义在一个单独js文件中,即一个js文件对应一个模块。
模块定义: define
define可以接收三个参数:
/**
* Defines a module.
* @param {string=} id The module id.
* @param {Array.|string=} deps The module dependencies.
* @param {function()|Object} factory The module factory function.
*/
fn.define = function(id, deps, factory) {
//code of function…
}
上面是我从SeaJS源码中摘录出来的,define可以接收的参数分别是模块ID,依赖模块数组及工厂函数。
define函数对于不同参数个数的解析规则如下:
- 如果只有一个参数,则赋值给factory。
- 如果有两个参数,第二个赋值给factory;第一个如果是array则赋值给deps,否则赋值给id。
- 如果有三个参数,则分别赋值给id,deps和factory。
最后一个参数始终当做 工厂函数,倒数第2个参数根据是否数组,确定是id 还是 deps
但是,包括SeaJS的官方示例在内几乎所有用到define的地方都只传递一个工厂函数进去,类似与如下代码:
// 使用最多的模块定义方式 只传工厂函数
define(function(require, exports, module) {
//code
});
个人建议遵循SeaJS官方示例的标准,用一个参数的define定义模块。那么id和deps会怎么处理呢?
id是一个模块的标识字符串,define只有factory参数时,id会被默认赋值为此js文件的绝对路径。
如example.com下的a.js文件中使用define定义模块,则这个模块的ID会赋值为 “http://example.com/a.js”,没有特别的必要建议不要传入id。
deps一般也不需要传入,需要用到的模块用require加载即可。
工厂函数factory解析
工厂函数是模块的主体和重点。在只传递factory给define时(推荐写法),factory的三个参数分别是:
require
模块加载函数,用于记载依赖模块。exports
接口点,将数据或方法定义在其上则将其暴露给外部调用。module
模块的元数据。
这三个参数可以根据需要选择是否需要显式指定。
下面说一下module。module是一个对象,存储了模块的元信息,具体如下:
- module.id 模块的ID。
- module.dependencies 一个数组,存储了此模块依赖的所有模块的ID列表。
- module.exports 与exports指向同一个对象。
三种编写模块的模式
基于exports的模式:
define(function (require, exports, module) {
var a = require('a'); //引入a模块
var b = require('b'); //引入b模块
var data1 = 1; //私有数据
var fn1 = function () { //私有方法
return a.run(data1);
}
exports.data2 = 2; //公共数据
exports.fn2 = function () { //公共方法
return 'hello';
}
});
将公共数据和方法附加在exports上,也可以直接返回一个对象表示模块,如下:
//工厂函数返回的对象会赋值给 module.exports
define(function (require) {
var a = require('a'); //引入a模块
var b = require('b'); //引入b模块
var data1 = 1; //私有数据
var fn1 = function () { //私有方法
return a.run(data1);
}
return {
data2: 2,
fn2: function () {
return 'hello';
}
};
});
如果模块定义没有其它代码,只返回一个对象,还可以有如下简化写法:(合适返回JSON数据的模块)
// 直接传入1个json,则json会被赋值给 module.exports
define({
data: 1,
fn: function () {
return 'hello';
}
});
模块的载入和引用
模块的寻址算法
上文说过一个模块对应一个js文件,而载入模块时一般都是提供一个字符串参数告诉载入函数需要的模块,所以就需要有一套从字符串标识到实际模块所在文件路径的解析算法。SeaJS
支持如下标识:
绝对地址
给出js文件的绝对路径。 如:require("http://example/js/a")
kk:js后缀可省略相对地址
如:require("./foo")
则相对于当前js文件寻找模块foo。基址地址
如果模块标识既不是绝对路径也不是以”./”开头,则相对SeaJS全局配置中的“base”来寻址,这种方法稍后讨论。
注意上面在载入模块时都不用传递后缀名.js
,SeaJS会自动添加.js
。但是下面三种情况下不会添加:
- 载入
css
时,如:require("./module1-style.css")
; - 路径中含有
?
时,如:require("http://example/js/a.json?cb=func")
; - 路径以
#结尾
时,如:require("http://example/js/a.json#")
;
根据应用场景的不同,SeaJS提供了三个载入模块的API,分别是seajs.use()
,require()
和require.async()
,下面分别介绍:
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
,例如,上面TinyApp的index.html也可以改为如下写法:
//data-main 指定入口模块 kk:貌似低版本的seajs不行
<scriptsrc="./sea.js" data-main="./init" ></script>
require()
require是SeaJS主要的模块加载方法,当在一个模块中需要用到其它模块时一般用require加载:
// backbone
var $ = require('jquery');
这里简要介绍一下SeaJS的自动加载机制。上文说过,使用SeaJS后html只要包含sea.js即可,那么其它js文件是如何加载进来的呢?
SeaJS会首先下载入口模块,然后顺着入口模块使用正则表达式匹配代码中所有的require,再根据require中的文件路径标识下载相应的js文件,对下载来的js文件再迭代进行类似操作。
整个过程类似图的遍历操作(因为可能存在交叉循环依赖所以整个依赖数据结构是一个图而不是树)。
明白了上面这一点,下面的规则就很好理解了:
传给require的路径标识必须是字符串字面量,不能是表达式,如下面使用require的方法是错误的:
//require的参数:路径标识必须是字符串字面量
require('module'+'1'); // error,
require('Module'.toLowerCase()); //error
require.async()
上文说过SeaJS会在html页面打开时通过静态分析一次性记载所有需要的js文件,如果想要某个js文件在用到时才下载,可以使用require.async:
require.async('/path/to/module/file',function(m) {
//code
});
这样只有在用到这个模块时,对应的js文件才会被下载,也就实现了JavaScript代码的按需加载。
// init.js:
define(function (require, exports, module) {
var $ = require('jquery');
var foo = require.async('foo', function (foo) {
console.log('in callback');
});
});
SeaJS的全局配置
seajs.config()
可以设置全局配置:
seajs.config({
base: 'path/to/jslib/',// 基地址
alias: {// 别名
'app': 'path/to/app/'
},
charset: 'utf-8',
timeout: 20000,
debug: false
});
base
基址路径。seajs.config({base: "http://example.com/js/3-party/"}); // 会载入http://example.com/js/3-party/jquery.js
var $ = require('jquery');
alias
对较长的常用路径设置别名。charset
表示下载js时script标签的charset属性。timeout
表示下载文件的最大时长,以毫秒为单位。debug
表示是否工作在调试模式下。
SeaJS与现有JS库配合使用
要将现有JS库如jQuery与SeaJS一起使用,只需根据SeaJS的的模块定义规则对现有库进行一个封装。例如:
// 把第三方库包装为模块
define(function () {
// jQuery源码
return $.noConflict();
});
SeaJS项目的打包部署
SeaJS本来集成了一个打包部署工具spm
,后来作者为了更KISS一点,将spm
拆出了SeaJS而成为了一个单独的项目。 spm
的核心思想是将所有模块的代码都合并压缩后并入入口模块,由于SeaJS本身的特性,html不需要做任何改动就可以很方便的在开发环境和生产环境 间切换。
其实,由于每个项目所用的JS合并和压缩工具不尽相同,所以spm可能并不是完全适合每个项目。在了解了SeaJS原理后,完全可以自己写一个符合自己项目特征的合并打包脚本。
如果一个模块为多个页面共用,这种情况seajs内部会怎么处理? 重复打包?
[转]seajs详解的更多相关文章
- 转: javascript模块加载框架seajs详解
javascript模块加载框架seajs详解 SeaJS是一个遵循commonJS规范的javascript模块加载框架,可以实现javascript的模块化开发和模块化加载(模块可按需加载或全部加 ...
- javascript模块加载框架seajs详解
SeaJS是一个遵循commonJS规范的javascript模块加载框架,可以实现javascript的模块化开发和模块化加载(模块可按需加载或全部加载).SeaJS可以和jQuery完美集成,使用 ...
- Javascript 异步加载详解
Javascript 异步加载详解 本文总结一下浏览器在 javascript 的加载方式. 关键词:异步加载(async loading),延迟加载(lazy loading),延迟执行(lazy ...
- 【微信小程序项目实践总结】30分钟从陌生到熟悉 web app 、native app、hybrid app比较 30分钟ES6从陌生到熟悉 【原创】浅谈内存泄露 HTML5 五子棋 - JS/Canvas 游戏 meta 详解,html5 meta 标签日常设置 C#中回滚TransactionScope的使用方法和原理
[微信小程序项目实践总结]30分钟从陌生到熟悉 前言 我们之前对小程序做了基本学习: 1. 微信小程序开发07-列表页面怎么做 2. 微信小程序开发06-一个业务页面的完成 3. 微信小程序开发05- ...
- Linq之旅:Linq入门详解(Linq to Objects)
示例代码下载:Linq之旅:Linq入门详解(Linq to Objects) 本博文详细介绍 .NET 3.5 中引入的重要功能:Language Integrated Query(LINQ,语言集 ...
- 架构设计:远程调用服务架构设计及zookeeper技术详解(下篇)
一.下篇开头的废话 终于开写下篇了,这也是我写远程调用框架的第三篇文章,前两篇都被博客园作为[编辑推荐]的文章,很兴奋哦,嘿嘿~~~~,本人是个很臭美的人,一定得要截图为证: 今天是2014年的第一天 ...
- EntityFramework Core 1.1 Add、Attach、Update、Remove方法如何高效使用详解
前言 我比较喜欢安静,大概和我喜欢研究和琢磨技术原因相关吧,刚好到了元旦节,这几天可以好好学习下EF Core,同时在项目当中用到EF Core,借此机会给予比较深入的理解,这里我们只讲解和EF 6. ...
- Java 字符串格式化详解
Java 字符串格式化详解 版权声明:本文为博主原创文章,未经博主允许不得转载. 微博:厉圣杰 文中如有纰漏,欢迎大家留言指出. 在 Java 的 String 类中,可以使用 format() 方法 ...
- Android Notification 详解(一)——基本操作
Android Notification 详解(一)--基本操作 版权声明:本文为博主原创文章,未经博主允许不得转载. 微博:厉圣杰 源码:AndroidDemo/Notification 文中如有纰 ...
随机推荐
- 利用JqGrid结合ashx显示列表之一
最近项目决定运用JqGrid列表控件显示相关数据,以前接触比较多还是easyui和Ext.Net的列表控件,文章简单写的小实例进行一个总结: 1:引入相关的JS及CSS文件,JqGrid目前可以利用J ...
- JavaWeb response对象常用操作
JavaWeb response对象常用操作 CreationTime--2018年7月18日10点42分 Author:Marydon 1.设置响应内容类型 方式一 response.setCo ...
- TWaver版3D化学元素周期表
非常早就有人做3D网页版的化学元素周期表了.酷炫效果和新奇技巧一度被众多粉丝奉为神明,争相研究和效仿.甚至有人放弃一切扑向这颗蜡烛.不由总是想到那个OPPO广告女主角拽拽的歧视道:"辞职去旅 ...
- JSON.parse 解析json字符串时,遇换行符报错
Json字符串转换成Json对象时候,有两种方式: 假设d是json字符串: 1,eval('(' + d + ')'). 2,JSON.parse(d): 但是以上方式有隐患,如果Json字符串有换 ...
- Python线程指南(转)
1. 线程基础 1.1. 线程状态 线程有5种状态,状态转换的过程如下图所示: 1.2. 线程同步(锁) 多线程的优势在于可以同时运行多个任务(至少感觉起来是这样).但是当线程需要共享数据时,可能存在 ...
- javascript异步代码的回调地狱以及JQuery.deferred提供的promise解决方式
我们先来看一下编写AJAX编码常常遇到的几个问题: 1.因为AJAX是异步的,全部依赖AJAX返回结果的代码必需写在AJAX回调函数中.这就不可避免地形成了嵌套.ajax等异步操作越多,嵌套层次就会越 ...
- python 火车票爬取代码
1.根据搜索词下载百度图片: # -*- coding: utf-8 -*- """根据搜索词下载百度图片""" import re imp ...
- centos vsftp 500 OOPS: cannot change directory
CentO中把vsftpd安裝配置好了,以為大功告成,但用FTP 登入出現下錯誤:500 OOPS: cannot change directoryCentOS系統安裝了SELinux,因為預設下是沒 ...
- PHP垃圾回收机制引用计数器概念
参考: http://www.phpddt.com/php/gc-refcounting-basics.html
- Linux iptables常用命令
iptables 是 Linux 中重要的访问控制手段,是俗称的 Linux 防火墙系统的重要组成部分.这里记录了iptables 防火墙规则的一些常用的操作指令. 下面的操作以 CentOS 为基础 ...