require.js的用法详解


Posted in Javascript onOctober 20, 2015

一、为什么要用require.js?

最早的时候,所有Javascript代码都写在一个文件里面,只要加载这一个文件就够了。后来,代码越来越多,一个文件不够了,必须分成多个文件,依次加载。下面的网页代码,相信很多人都见过。

 <script src="1.js"></script>
<script src="2.js"></script>

<script src="3.js"></script>

<script src="4.js"></script>

<script src="5.js"></script>

<script src="6.js"></script>

这段代码依次加载多个js文件。

这样的写法有很大的缺点。首先,加载的时候,浏览器会停止网页渲染,加载文件越多,网页失去响应的时间就会越长;其次,由于js文件之间存在依赖关系,因此必须严格保证加载顺序(比如上例的1.js要在2.js的前面),依赖性最大的模块一定要放到最后加载,当依赖关系很复杂的时候,代码的编写和维护都会变得困难。

require.js的诞生,就是为了解决这两个问题:

require.js的用法详解

(1)实现js文件的异步加载,避免网页失去响应;

(2)管理模块之间的依赖性,便于代码的编写和维护。

二、require.js的加载

使用require.js的第一步,是先去官方网站下载最新版本。

下载后,假定把它放在js子目录下面,就可以加载了。

<script src="js/require.js"></script>

有人可能会想到,加载这个文件,也可能造成网页失去响应。解决办法有两个,一个是把它放在网页底部加载,另一个是写成下面这样:

<script src="js/require.js" defer async="true" ></script>

async属性表明这个文件需要异步加载,避免网页失去响应。IE不支持这个属性,只支持defer,所以把defer也写上。

加载require.js以后,下一步就要加载我们自己的代码了。假定我们自己的代码文件是main.js,也放在js目录下面。那么,只需要写成下面这样就行了:

 <script src="js/require.js" data-main="js/main"></script>

data-main属性的作用是,指定网页程序的主模块。在上例中,就是js目录下面的main.js,这个文件会第一个被require.js加载。由于require.js默认的文件后缀名是js,所以可以把main.js简写成main。

三、主模块的写法

上一节的main.js,我把它称为"主模块",意思是整个网页的入口代码。它有点像C语言的main()函数,所有代码都从这儿开始运行。

下面就来看,怎么写main.js。

如果我们的代码不依赖任何其他模块,那么可以直接写入javascript代码。

// main.js

alert("加载成功!");

但这样的话,就没必要使用require.js了。真正常见的情况是,主模块依赖于其他模块,这时就要使用AMD规范定义的的require()函数。

// main.js
require(['moduleA', 'moduleB', 'moduleC'], function (moduleA, moduleB, moduleC){


// some code here

});

require()函数接受两个参数。第一个参数是一个数组,表示所依赖的模块,上例就是['moduleA', 'moduleB', 'moduleC'],即主模块依赖这三个模块;第二个参数是一个回调函数,当前面指定的模块都加载成功后,它将被调用。加载的模块会以参数形式传入该函数,从而在回调函数内部就可以使用这些模块。

require()异步加载moduleA,moduleB和moduleC,浏览器不会失去响应;它指定的回调函数,只有前面的模块都加载成功后,才会运行,解决了依赖性的问题。

下面,我们看一个实际的例子。

假定主模块依赖jquery、underscore和backbone这三个模块,main.js就可以这样写:

require(['jquery', 'underscore', 'backbone'], function ($, _, Backbone){


// some code here

});

require.js会先加载jQuery、underscore和backbone,然后再运行回调函数。主模块的代码就写在回调函数中。

四、模块的加载

上一节最后的示例中,主模块的依赖模块是['jquery', 'underscore', 'backbone']。默认情况下,require.js假定这三个模块与main.js在同一个目录,文件名分别为 jquery.js,underscore.js和backbone.js,然后自动加载。

使用require.config()方法,我们可以对模块的加载行为进行自定义。require.config()就写在主模块(main.js)的头部。参数就是一个对象,这个对象的paths属性指定各个模块的加载路径。

require.config({

paths: {



"jquery": "jquery.min",



"underscore": "underscore.min",



"backbone": "backbone.min"


}

});

上面的代码给出了三个模块的文件名,路径默认与main.js在同一个目录(js子目录)。如果这些模块在其他目录,比如js/lib目录,则有两种写法。一种是逐一指定路径。

require.config({

paths: {



"jquery": "lib/jquery.min",



"underscore": "lib/underscore.min",



"backbone": "lib/backbone.min"


}

});

另一种则是直接改变基目录(baseUrl)。

require.config({

baseUrl: "js/lib",


paths: {



"jquery": "jquery.min",



"underscore": "underscore.min",



"backbone": "backbone.min"


}

});

如果某个模块在另一台主机上,也可以直接指定它的网址,比如:

require.config({

paths: {



"jquery": "https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min"


}

});

require.js要求,每个模块是一个单独的js文件。这样的话,如果加载多个模块,就会发出多次HTTP请求,会影响网页的加载速度。因此,require.js提供了一个优化工具,当模块部署完毕以后,可以用这个工具将多个模块合并在一个文件中,减少HTTP请求数。

五、AMD模块的写法

require.js加载的模块,采用AMD规范。也就是说,模块必须按照AMD的规定来写。

具体来说,就是模块必须采用特定的define()函数来定义。如果一个模块不依赖其他模块,那么可以直接定义在define()函数之中。

假定现在有一个math.js文件,它定义了一个math模块。那么,math.js就要这样写:

// math.js
define(function (){


var add = function (x,y){



return x+y;


};


return {



add: add


};

});

加载方法如下:

// main.js

require(['math'], function (math){


alert(math.add(1,1));

});

如果这个模块还依赖其他模块,那么define()函数的第一个参数,必须是一个数组,指明该模块的依赖性。

define(['myLib'], function(myLib){

function foo(){



myLib.doSomething();


}


return {



foo : foo


};

});

当require()函数加载上面这个模块的时候,就会先加载myLib.js文件。

六、加载非规范的模块

理论上,require.js加载的模块,必须是按照AMD规范、用define()函数定义的模块。但是实际上,虽然已经有一部分流行的函数库(比如jQuery)符合AMD规范,更多的库并不符合。那么,require.js是否能够加载非规范的模块呢?回答是可以的。这样的模块在用require()加载之前,要先用require.config()方法,定义它们的一些特征。举例来说,underscore和backbone这两个库,都没有采用AMD规范编写。如果要加载它们的话,必须先定义它们的特征。

require.config({

shim: {



'underscore':{




exports: '_'



},



'backbone': {




deps: ['underscore', 'jquery'],




exports: 'Backbone'



}


}

});

require.config()接受一个配置对象,这个对象除了有前面说过的paths属性之外,还有一个shim属性,专门用来配置不兼容的模块。具体来说,每个模块要定义(1)exports值(输出的变量名),表明这个模块外部调用时的名称;(2)deps数组,表明该模块的依赖性。

比如,jQuery的插件可以这样定义:

 shim: {

'jquery.scroll': {



deps: ['jquery'],



exports: 'jQuery.fn.scroll'


}

}

七、require.js插件

require.js还提供一系列插件,实现一些特定的功能。

domready插件,可以让回调函数在页面DOM结构加载完成后再运行。

 shim: {

'jquery.scroll': {



deps: ['jquery'],



exports: 'jQuery.fn.scroll'


}

}

text和image插件,则是允许require.js加载文本和图片文件。

define([

'text!review.txt',


'image!cat.jpg'


],


function(review,cat){



console.log(review);



document.body.appendChild(cat);


}

);

类似的插件还有json和mdown,用于加载json文件和markdown文件。

以上就是本文的全部所述,希望本文分享对大家有所帮助。

Javascript 相关文章推荐
javascript同步Import,同步调用外部js的方法
Jul 08 Javascript
document.documentElement和document.body区别介绍
Sep 16 Javascript
JavaScript统计字符串中每个字符出现次数完整实例
Jan 28 Javascript
Select下拉框模糊查询功能实现代码
Jul 22 Javascript
详解JavaScript RegExp对象
Feb 04 Javascript
jquery设置css样式的多种方法(总结)
Feb 21 Javascript
vue组件间通信解析
Mar 01 Javascript
使用rollup打包JS的方法步骤
Dec 05 Javascript
如何从头实现一个node.js的koa框架
Jun 17 Javascript
layui数据表格实现重载数据表格功能(搜索功能)
Jul 27 Javascript
微信浏览器下拉黑边解决方案 wScroollFix
Jan 21 Javascript
微信小程序语音同步智能识别的实现案例代码解析
May 29 Javascript
JS实现鼠标滑过链接改变网页背景颜色的方法
Oct 20 #Javascript
JS实现带有3D立体感的银灰色竖排折叠菜单代码
Oct 20 #Javascript
jquery如何获取元素的滚动条高度等实现代码
Oct 19 #Javascript
js验证身份证号有效性并提示对应信息
Oct 19 #Javascript
详解JavaScript数组的操作大全
Oct 19 #Javascript
全系IE支持Bootstrap的解决方法
Oct 19 #Javascript
JS+CSS实现分类动态选择及移动功能效果代码
Oct 19 #Javascript
You might like
php的hash算法介绍
2014/02/13 PHP
yii操作session实例简介
2014/07/31 PHP
php创建、获取cookie及基础要点分析
2015/01/26 PHP
Laravel相关的一些故障解决
2020/08/19 PHP
统一接口:为FireFox添加IE的方法和属性的js代码
2007/03/25 Javascript
在网页里看flash的trace数据的js类
2009/01/10 Javascript
基于jQuery的js分页代码
2010/06/10 Javascript
同一页面多个商品倒计时JS 基于面向对象的javascript
2012/02/16 Javascript
无缝滚动js代码通俗易懂(自写)
2013/06/19 Javascript
js为空或不是对象问题的快速解决方法
2013/12/11 Javascript
文本框(input)获取焦点(onfocus)时样式改变的示例代码
2014/01/10 Javascript
JS实现统计复选框选中个数并提示确定与取消的方法
2015/07/01 Javascript
JQUERY实现网页右下角固定位置展开关闭特效的方法
2015/07/27 Javascript
jQuery事件对象总结
2016/10/17 Javascript
Nodejs之http的表单提交
2017/07/07 NodeJs
JS实现电脑虚拟键盘打字测试
2020/06/24 Javascript
Python搜索引擎实现原理和方法
2017/11/27 Python
使用python实现ANN
2017/12/20 Python
PyQt QCombobox设置行高的方法
2019/06/20 Python
如何利用Anaconda配置简单的Python环境
2019/06/24 Python
Python测试模块doctest使用解析
2019/08/10 Python
python super的使用方法及实例详解
2019/09/25 Python
selenium WebDriverWait类等待机制的实现
2020/03/18 Python
Python性能分析工具py-spy原理用法解析
2020/07/27 Python
python解包概念及实例
2021/02/17 Python
CSS3实现的文本3D效果附图
2014/09/03 HTML / CSS
CSS3 按钮边框动画的实现
2020/11/12 HTML / CSS
Gtech官方网站:地毯清洁器、吸尘器及园艺设备
2018/05/23 全球购物
美国基督教约会网站:ChristianCafe.com
2020/02/04 全球购物
自荐书格式
2013/12/01 职场文书
十八大宣传标语
2014/10/09 职场文书
简历中自我评价范文
2015/03/11 职场文书
2015党建工作简报
2015/07/21 职场文书
2016三严三实专题教育活动心得体会
2016/01/06 职场文书
《围炉夜话》110句人生箴言,精辟有内涵,引人深思
2019/10/23 职场文书
读《钢铁是怎样炼成的》有感:百炼方成钢
2019/11/05 职场文书