基本API
require會(huì)定義三個(gè)變量:define,require,requirejs,其中require === requirejs,一般使用require更簡(jiǎn)短
define 從名字就可以看出這個(gè)api是用來(lái)定義一個(gè)模塊
require 加載依賴(lài)模塊,并執(zhí)行加載完后的回調(diào)函數(shù)
前一篇中的a.js:
define(function(){
function fun1(){
alert("it works");
}
fun1();
})
通過(guò)define函數(shù)定義了一個(gè)模塊,然后再頁(yè)面中使用:
require(["js/a"]);
來(lái)加載該模塊(注意require中的依賴(lài)是一個(gè)數(shù)組,即使只有一個(gè)依賴(lài),你也必須使用數(shù)組來(lái)定義),requir API的第二個(gè)參數(shù)是callback,一個(gè)function,是用來(lái)處理加載完畢后的邏輯,如:
require(["js/a"],function(){
alert("load finished");
})
加載文件
之前的例子中加載模塊都是本地js,但是大部分情況下網(wǎng)頁(yè)需要加載的JS可能來(lái)自本地服務(wù)器、其他網(wǎng)站或CDN,這樣就不能通過(guò)這種方式來(lái)加載了,我們以加載一個(gè)jquery庫(kù)為例:
require.config({
paths : {
"jquery" : ["http://libs.baidu.com/jquery/2.0.3/jquery"]
}
})
require(["jquery","js/a"],function($){
$(function(){
alert("load finished");
})
})
這邊涉及了require.config,require.config是用來(lái)配置模塊加載位置,簡(jiǎn)單點(diǎn)說(shuō)就是給模塊起一個(gè)更短更好記的名字,比如將百度的jquery庫(kù)地址標(biāo)記為jquery,這樣在require時(shí)只需要寫(xiě)["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");
})
})
通過(guò)paths的配置會(huì)使我們的模塊名字更精煉,paths還有一個(gè)重要的功能,就是可以配置多個(gè)路徑,如果遠(yuǎn)程cdn庫(kù)沒(méi)有加載成功,可以加載本地的庫(kù),如:
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");
})
})
這樣配置后,當(dāng)百度的jquery沒(méi)有加載成功后,會(huì)加載本地js目錄下的jquery
在使用requirejs時(shí),加載模塊時(shí)不用寫(xiě).js后綴的,當(dāng)然也是不能寫(xiě)后綴
上面例子中的callback函數(shù)中發(fā)現(xiàn)有$參數(shù),這個(gè)就是依賴(lài)的jquery模塊的輸出變量,如果你依賴(lài)多個(gè)模塊,可以依次寫(xiě)入多個(gè)參數(shù)來(lái)使用:
require(["jquery","underscore"],function($, _){
$(function(){
_.each([1,2,3],alert);
})
})
如果某個(gè)模塊不輸出變量值,則沒(méi)有,所以盡量將輸出的模塊寫(xiě)在前面,防止位置錯(cuò)亂引發(fā)誤解
全局配置
上面的例子中重復(fù)出現(xiàn)了require.config配置,如果每個(gè)頁(yè)面中都加入配置,必然顯得十分不雅,requirejs提供了一種叫"主數(shù)據(jù)"的功能,我們首先創(chuàng)建一個(gè)main.js:
require.config({
paths : {
"jquery" : ["http://libs.baidu.com/jquery/2.0.3/jquery", "js/jquery"],
"a" : "js/a"
}
})
然后再頁(yè)面中使用下面的方式來(lái)使用requirejs:
<script data-main="js/main" src="js/require.js"></script>
解釋一下,加載requirejs腳本的script標(biāo)簽加入了data-main屬性,這個(gè)屬性指定的js將在加載完reuqire.js后處理,我們把require.config的配置加入到data-main后,就可以使每一個(gè)頁(yè)面都使用這個(gè)配置,然后頁(yè)面中就可以直接使用require來(lái)加載所有的短模塊名
data-main還有一個(gè)重要的功能,當(dāng)script標(biāo)簽指定data-main屬性時(shí),require會(huì)默認(rèn)的將data-main指定的js為根路徑,是什么意思呢?如上面的data-main="js/main"設(shè)定后,我們?cè)谑褂胷equire(['jquery'])后(不配置jquery的paths),require會(huì)自動(dòng)加載js/jquery.js這個(gè)文件,而不是jquery.js,相當(dāng)于默認(rèn)配置了:
require.config({
baseUrl : "js"
})
第三方模塊
通過(guò)require加載的模塊一般都需要符合AMD規(guī)范即使用define來(lái)申明模塊,但是部分時(shí)候需要加載非AMD規(guī)范的js,這時(shí)候就需要用到另一個(gè)功能:shim,shim解釋起來(lái)也比較難理解,shim直接翻譯為"墊",其實(shí)也是有這層意思的,目前我主要用在兩個(gè)地方
1. 非AMD模塊輸出,將非標(biāo)準(zhǔn)的AMD模塊"墊"成可用的模塊,例如:在老版本的jquery中,是沒(méi)有繼承AMD規(guī)范的,所以不能直接require["jquery"],這時(shí)候就需要shim,比如我要是用underscore類(lèi)庫(kù),但是他并沒(méi)有實(shí)現(xiàn)AMD規(guī)范,那我們可以這樣配置
require.config({
shim: {
"underscore" : {
exports : "_";
}
}
})
這樣配置后,我們就可以在其他模塊中引用underscore模塊:
require(["underscore"], function(_){
_.each([1,2,3], alert);
})
插件形式的非AMD模塊,我們經(jīng)常會(huì)用到j(luò)query插件,而且這些插件基本都不符合AMD規(guī)范,比如jquery.form插件,這時(shí)候就需要將form插件"墊"到j(luò)query中:
require.config({
shim: {
"underscore" : {
exports : "_";
},
"jquery.form" : {
deps : ["jquery"]
}
}
})
也可以簡(jiǎn)寫(xiě)為:
require.config({
shim: {
"underscore" : {
exports : "_";
},
"jquery.form" : ["jquery"]
}
})
這樣配置之后我們就可以使用加載插件后的jquery了
require.config(["jquery", "jquery.form"], function($){
$(function(){
$("#form").ajaxSubmit({...});
})
})
好了,requirejs的基本配置大致就是這么多,還有一些擴(kuò)展的功能會(huì)在之后的篇幅中提到,大家不要錯(cuò)過(guò)呀!