requireJS是javascript的模块加载器,是基于AMD规范实现的。
r.js是其提供的对模块进行打包和构建的一个工具
下载 r.js
创建r.js 的配置文件 build.js
build.js
1 ({ 2 baseUrl: './js/pages', //相对于appDir,代表要查找js文件的起始文件夹,下文所有文件路径的定义都是基于这个baseUrl的 3 4 appDir: './', //项目根目录 5 dir: './outdir', //输出目录,全部文件打包后要放入的文件夹(如果没有会自动新建的) 6 /* 有了dir,就不能使用out配置项了,你在编译时它有非常明确的提示 */ 7 /*"appDir" is not compatible with "out". Use "dir" instead. appDir is used to copy whole projects, where "out" with "baseUrl" is used to just optimize to one file.*/ 8 /*"appDir" 和 "out"是不兼容的,需要用"dir"代替, "appDir"是用来拷贝整个项目的,"out"和"baseUrl"仅是用来优化一个文件的*/ 9 modules: [ 10 //要优化的模块 —— 里面的配置项即各页面的 相对baseUrl路径的 省略后缀“.js”的 入口文件(入口文件 ---- 即加载页面时引入require.js的script标签上data-main属性所指定的文件) 11 //该属性必不可少,因为一个程序至少需要有一个入口 12 { name:'main'}, 13 { name:'index'} 14 ],
15 out: 'index-build.js', //输出文件名 16 name:'main',
17 fileExclusionRegExp: /^(r|build)\.js|.*\.scss$/, //正则匹配过滤文件,匹配到的文件将不会被输出到输出目录去,这里过滤掉的是 r.js、build.js、*.scss三类文件 18 optimizeCss: 'standard', 19 removeCombined: true, //如果为true,优化器将从输出目录中删除已合并的文件 20 paths: { //各模块相对baseUrl的路径,直接从require.config的path配置中烤取即可 21 "underscore": "../libs/underscore/underscore-min", 22 "backbone": "../libs/backbone/backbone-min", 23 }, 24 shim:{// 配置不符合AMD规范的模块,直接从require.config的shim配置中烤取即可 25 "underscore": { 26 exports: "_" 27 }, 28 "backbone": { 29 deps: ["underscore", "jquery"], 30 exports: "Backbone" 31 }, 32 } 33 })
常用的build.js的参数属性解释:
r.js把各页面所需要用到的脚本全部都整合到各自的入口文件(一个或多个js)中去,从而减少了对服务器的请求。
mainConfigFile:'common.js' //多页面复杂工程的多个入库文件的统一的 require.config 的配置放置文件,相对baseUrl的路径
由于多页面工程需要多个入库文件,此时就会出现相同的 require config 的在一个工程下配置多次的问题,为了避免这种问题,可以将多个入库文件的相同config提出到一个js文件中,进行统一配置,
并且就会用到build.js的mainConfigFile参数来对其进行重新定义模块
baseUrl
---- 必不可少项,将要打包的所有文件的相对公共路径
appDir,dir,modules
---- 当一个程序有多个入口文件的时候
---- 将相应文件打包至配置的dir目录中
---- 各页面的入口文件不用改变,还是相应的入口文件即可
out,name
---- 当程序只有一个入口文件的时候
---- 将要打包的所有文件压缩到配置的out文件中
---- 项目入口index.html页面的入口文件需改为out的位置文件
实例可参考:https://github.com/requirejs/example-multipage-shim
一篇通俗易懂的r.js打包应用简例:http://www.tuicool.com/articles/iYNJbqZ
http://www.cnblogs.com/vajoy/p/3920163.html#!/follow
http://requirejs.org/docs/start.html
一个简单打包的例子!
久闻r.js的大名,但实际没有用它做过任何东西。今天用它时,发现网上许多教程都不对。研究一下,把我的实际经验分享给大家。
例子1
先是HTML页面
<!DOCTYPE html>
<html>
<head>
<title>My App</title>
<link rel="stylesheet" type="text/css" href="css/main.css">
<script data-main="scripts/main-built" src="scripts/require.js"></script>
</head>
<body>
<h1>My App</h1>
</body>
</html>
js都放在scripts目录下,换言之 html与scripts是平级。此目录下有r.js, require.js, one.js, two.js, three.js, main.js
上面HTML提到的main-built.js是一会儿动态生成的。
r.js 可以在这里找到 https://github.com/jrburke/r.js/blob/master/dist/r.js ,总共7MB,非常疯狂!听说把各种情况都hold住了, 比spm强大多了!
接着是几个JS的内容:
one.js
define(function(){
return 1
})
two.js
define(function(){
return 2
})
three.js
define(function(){
return 3
})
main.js
require(["one", "two", "three"], function (one, two, three) {
alert(one+two+three)
});
好了,我们再看一下build.js如何写
({
baseUrl: ".",
name: "main",
out: "main-built.js"
})
定位到此目的,执行node r.js -o build.js
最后生成main-built.js文件,我格式化它一下,里面内容如下:
define("one",[],function(){return 1}),
define("two",[],function(){return 2}),
define("three",[],function(){return 3}),
require(["one","two","three"],function(e,t,n){alert(e+t+n)}),define("main",function(){});
最后运行服务器,发现真的能alert出6!