前一篇:JS模塊化工具咱們以很是簡單的方式引入了requirejs,這一篇將講述一下requirejs中的一些基本知識,包括API使用方式等javascript
require會定義三個變量:define,require,requirejs,其中require === requirejs,通常使用require更簡短html
前一篇中的a.js:java
define(function(){ function fun1(){ alert("it works"); } fun1(); })
經過define函數定義了一個模塊,而後再頁面中使用:jquery
require(["js/a"]);
來加載該模塊(注意require中的依賴是一個數組,即便只有一個依賴,你也必須使用數組來定義),requir API的第二個參數是callback,一個function,是用來處理加載完畢後的邏輯,如:git
require(["js/a"],function(){ alert("load finished"); })
以前的例子中加載模塊都是本地js,可是大部分狀況下網頁須要加載的JS可能來自本地服務器、其餘網站或CDN,這樣就不能經過這種方式來加載了,咱們以加載一個jquery庫爲例:github
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
是用來配置模塊加載位置,簡單點說就是給模塊起一個更短更好記的名字,好比將百度的jquery庫地址標記爲jquery
,這樣在require時只須要寫["jquery"]
就能夠加載該js,本地的js咱們也能夠這樣配置:ajax
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庫沒有加載成功,能夠加載本地的庫,如:api
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數組
.js
後綴的,固然也是不能寫後綴$
參數,這個就是依賴的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將在加載完reuqire.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規範的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); })
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的基本配置大體就是這麼多,還有一些擴展的功能會在以後的篇幅中提到
文章來源:https://github.com/liuxey/blog/issues/2