【requirejs】JS模块化工具requirejs教程

时间:2024-11-09 18:05:02

初识requirejs

随着网站功能逐渐丰富,网页中的js也变得越来越复杂和臃肿,原有通过script标签来导入一个个的js文件这种方式已经不能满足现在互联网开发模式,我们需要团队协作、模块复用、单元测试等等一系列复杂的需求。

【requirejs】JS模块化工具requirejs教程

RequireJS是一个非常小巧的JavaScript模块载入框架,是AMD规范最好的实现者之一。最新版本的RequireJS压缩后只有14K,堪称非常轻量。它还同时可以和其他的框架协同工作,使用RequireJS必将使您的前端代码质量得以提升。

requirejs能带来什么好处

官方对requirejs的描述:

RequireJS is a JavaScript file and module loader. It is optimized for in-browser use, but it can be used in other JavaScript environments, like Rhino and Node. Using a modular script loader like RequireJS will improve the speed and quality of your code.

大致意思:

在浏览器中可以作为js文件的模块加载器,也可以用在Node和Rhino环境,balabala...。这段话描述了requirejs的基本功能"模块化加载",什么是模块化加载?我们要从之后的篇幅中一一解释

先来看一段常见的场景,通过示例讲解如何运用requirejs

正常编写方式

index.html:

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="a.js"></script>
</head>
<body>
<span>body</span>
</body>
</html>

a.js:

function fun1(){
alert("it works");
} fun1();

可能你更喜欢这样写

(function(){
function fun1(){
alert("it works");
} fun1();
})()

第二种方法使用了块作用域来申明function防止污染全局变量,本质还是一样的,当运行上面两种例子时不知道你是否注意到,alert执行的时候,html内容是一片空白的,即<span>body</span>并未被显示,当点击确定后,才出现,这就是JS阻塞浏览器渲染导致的结果。

requirejs写法

当然首先要到requirejs的网站去下载js -> requirejs.org
index.html:

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="require.js"></script>
<script type="text/javascript">
require(["a"]);
</script>
</head>
<body>
<span>body</span>
</body>
</html>

a.js:

define(function(){
function fun1(){
alert("it works");
} fun1();
})

浏览器提示了"it works",说明运行正确,但是有一点不一样,这次浏览器并不是一片空白,body已经出现在页面中,目前为止可以知道requirejs具有如下优点:

  1. 防止js加载阻塞页面渲染
  2. 使用程序调用的方式加载js,防出现如下丑陋的场景
<script type="text/javascript" src="a.js"></script>
<script type="text/javascript" src="b.js"></script>
<script type="text/javascript" src="c.js"></script>
<script type="text/javascript" src="d.js"></script>
<script type="text/javascript" src="e.js"></script>
<script type="text/javascript" src="f.js"></script>
<script type="text/javascript" src="g.js"></script>
<script type="text/javascript" src="h.js"></script>
<script type="text/javascript" src="i.js"></script>
<script type="text/javascript" src="j.js"></script>

require.js解决了两个问题:

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

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

基本知识

基本API

require会定义三个变量:define,require,requirejs,其中require === requirejs,一般使用require更简短

  • define 从名字就可以看出这个api是用来定义一个模块
  • require 加载依赖模块,并执行加载完后的回调函数

前一篇中的a.js:

define(function(){
function fun1(){
alert("it works");
} fun1();
})

通过define函数定义了一个模块,然后再页面中使用:

require(["js/a"]);

来加载该模块(注意require中的依赖是一个数组,即使只有一个依赖,你也必须使用数组来定义),require API的第二个参数是callback,一个function,是用来处理加载完毕后的逻辑,如:

require(["js/a"],function(){
alert("load finished");
})
require()异步加载模块,浏览器不会失去响应;它指定的回调函数,只有前面的模块都加载成功后,才会运行,解决了依赖性的问题。

加载文件

之前的例子中加载模块都是本地js,但是大部分情况下网页需要加载的JS可能来自本地服务器、其他网站或CDN,这样就不能通过这种方式来加载了,我们以加载一个jquery库为例:

require.config({
paths : {
"jquery" : ["http://libs.baidu.com/jquery/2.0.3/jquery"]
}
})
require(["jquery","js/a"],function($){
$(function(){
alert("load finished");
})
})

这边涉及了require.configrequire.config是用来配置模块加载位置,简单点说就是给模块起一个更短更好记的名字,比如将百度的jquery库地址标记为jquery,这样在require时只需要写["jquery"]就可以加载该js,本地的js我们也可以这样配置:

require.config({
paths : {
"jquery" : ["http://libs.baidu.com/jquery/2.0.3/jquery"],
"a" : "js/a"
}
})
require(["jquery","a"],function($){
$(function(){
alert("load finished");
})
})

通过paths的配置会使我们的模块名字更精炼,paths还有一个重要的功能,就是可以配置多个路径,如果远程cdn库没有加载成功,可以加载本地的库,如:

require.config({
paths : {
"jquery" : ["http://libs.baidu.com/jquery/2.0.3/jquery", "js/jquery"],
"a" : "js/a"
}
})
require(["jquery","a"],function($){
$(function(){
alert("load finished");
})
})

这样配置后,当百度的jquery没有加载成功后,会加载本地js目录下的jquery

  1. 在使用requirejs时,加载模块时不用写.js后缀的,当然也是不能写后缀
  2. 上面例子中的callback函数中发现有$参数,这个就是依赖的jquery模块的输出变量,如果你依赖多个模块,可以依次写入多个参数来使用:
require(["jquery","underscore"],function($, _){
$(function(){
_.each([1,2,3],alert);
})
})

如果某个模块不输出变量值,则没有,所以尽量将输出的模块写在前面,防止位置错乱引发误解

全局配置

上面的例子中重复出现了require.config配置,如果每个页面中都加入配置,必然显得十分不雅,requirejs提供了一种叫"主数据"的功能,我们首先创建一个main.js:

require.config({
paths : {
"jquery" : ["http://libs.baidu.com/jquery/2.0.3/jquery", "js/jquery"],
"a" : "js/a"
}
})

然后再页面中使用下面的方式来使用requirejs:

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

解释一下,加载 requirejs 脚本的 script 标签加入了data-main属性,这个属性指定的 js 将在加载完 require.js 后处理,我们把require.config的配置加入到data-main后,就可以使每一个页面都使用这个配置,然后页面中就可以直接使用require来加载所有的短模块名

data-main还有一个重要的功能,当script标签指定data-main属性时,require会默认的将data-main指定的js为根路径,是什么意思呢?如上面的data-main="js/main"设定后,我们在使用require(['jquery'])后(不配置jquery的paths),require会自动加载js/jquery.js这个文件,而不是jquery.js,相当于默认配置了:

require.config({
baseUrl : "js"
})

第三方模块

通过require加载的模块一般都需要符合AMD规范即使用define来申明模块,具体来说,AMD规范就是模块必须采用特定的define()函数来定义。如果一个模块不依赖其他模块,那么可以直接定义在define()函数之中。

但是部分时候需要加载非AMD规范的js,这时候就需要用到另一个功能:shim,shim解释起来也比较难理解,shim直接翻译为"垫",其实也是有这层意思的,目前我主要用在两个地方
1. 非AMD模块输出,将非标准的AMD模块"垫"成可用的模块,例如:在老版本的jquery中,是没有继承AMD规范的,所以不能直接require["jquery"],这时候就需要shim,比如我要是用underscore类库,但是他并没有实现AMD规范,那我们可以这样配置

require.config({
shim: {
"underscore" : {
exports : "_";
}
}
})

这样配置后,我们就可以在其他模块中引用underscore模块:

require(["underscore"], function(_){
_.each([1,2,3], alert);
})
  1. 插件形式的非AMD模块,我们经常会用到jquery插件,而且这些插件基本都不符合AMD规范,比如jquery.form插件,这时候就需要将form插件"垫"到jquery中:
require.config({
shim: {
"underscore" : {
exports : "_";
},
"jquery.form" : {
deps : ["jquery"]
}
}
})

也可以简写为:

require.config({
shim: {
"underscore" : {
exports : "_";
},
"jquery.form" : ["jquery"]
}
})

这样配置之后我们就可以使用加载插件后的jquery了

require.config(["jquery", "jquery.form"], function($){
$(function(){
$("#form").ajaxSubmit({...});
})
})

requireJS使用步骤

1、引入requireJS

nuget下载requirejs,在body中通过<script>引入

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

在require.js 加载完毕时,会自动去加载配置文件 main.js。

2、基本参数配置

//main.js

require.config({

baseUrl:’’,  //定义基准目录

paths:{       //key/value,key=模块id(自己定义),value=js文件名(不需要.js)

}

})

3、定义模块

我们以后所编写的代码或者是某段功能,都是要放在一个个定义好的模块中。
下面是requireJS定义模块的方法格式:

define([id,deps,] callback);

ID:模块的ID,默认的便是文件名,一般无需使用者自己手动指定。
deps:当前模块所有依赖的模块数组,数组的每个数组元素便是模块名或者叫模块ID。
callback:模块的回调方法,用于保存模块具体的功能与代码,而这个回调函数又接收一个或者多个参数,这些参数会与模块数组的每个数组元素一一对应,即每个参数保存的是对应模块返回值。

返回结果可以是一个对象,也可以是一个函数。

方式:return

根据 define() 使用时参数数量的不同,可以定义以下几种模块类型:

1、简单键值对

当所要定义的模块没有任何依赖也不具有任何的功能,只是单纯的返回一组键值对形式的数据时,便可以直接将要返回的数据对象写在 define方法中:

//define1.js

//模块定义1,无依赖无功能函数

define({

    'color': 'red',

    'size': '13px',

    'width': '100px'

});

这种只为保存数据的模块,我们称之为“值对”模块

使用(加载模块)

//app.js

//配置

require.config({

    baseUrl: 'Scripts/',

    paths: {

        "jquery": "jquery-3.3.1",

        "define1": "app/define1",

        "define2": "app/define2",

        "define3": "app/define3",

    }

})

//加载模块1

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

    for (var prop in define1) {

        if (define1.hasOwnProperty(prop)) {

            console.log('key =' + prop + ' and value = ' + define1[prop]);

        }

    }  

})

2、非依赖的函数式定义

如果一个模块没有任何的依赖,只是单纯的执行一些操作,那么便可以直接将函数写在 define方法中

//define2.js

//模块定义2,无依赖 但功能函数,返回一个对象

define(function () {

    return {

        'color': 'red',

        'size': '13px',

    }

})

使用(加载模块)

require(['define1', 'define2'], function (define1, define2) {

    console.log("define1");

    for (var prop in define1) {

        if (define1.hasOwnProperty(prop)) {

            console.log('key =' + prop + ' and value = ' + define1[prop]);

        }

    }

    console.log("define2");

    for (var prop in define2) {

        if (define2.hasOwnProperty(prop)) {

            console.log('key =' + prop + ' and value = ' + define2[prop]);

        }

    }

})

3、依赖的函数式定义

这种带有依赖的函数式模块定义,也是我们平时常用到的,

//define3.js

//模块定义3,依赖的函数式定义  但功能函数,返回一个对象

define(['jquery','define2'],function ($,define2) {

    obj= {

        'color': 'red',

        'size': '13px',

    }

    $(function () {

        console.log(obj.color);

        console.log(define2.size);

    })

   // console.log(define2.size);  //放这里 会在一开始就输出,

})

使用(加载模块)

//app.js

//配置

require.config({

    baseUrl: 'Scripts/',

    paths: {

        "jquery": "jquery-3.3.1",

        "define1": "app/define1",

        "define2": "app/define2",

        "define3": "app/define3",

    }

})

require(['define1', 'define2', 'define3'], function (define1, define2, define3) {

    console.log("define1");

    for (var prop in define1) {

        if (define1.hasOwnProperty(prop)) {

            console.log('key =' + prop + ' and value = ' + define1[prop]);

        }

    }

    console.log("define2");

    for (var prop in define2) {

        if (define2.hasOwnProperty(prop)) {

            console.log('key =' + prop + ' and value = ' + define2[prop]);

        }

    }

    console.log("define3");

})

4、载入模块

格式require(deps,[callback]);

deps:所要载入的模块数组。
callback:模块载入后执行的回调方法。

模块之前因为有依赖,故不用载入所有模块,载入一个的时候,会自动载入其所依赖的模块(这个定义模块里面有
依赖关系)

callBcak定义和 定义模块时的回调函数类似。。

更多参考:
阮一峰 require.js的用法
RequireJS中文网