需要依條件載入腳本或樣式表時,有兩種常見做法:一是用 document.write 直接寫入標籤(僅適用於頁面初次解析階段),二是建立元素後掛進 head。以下提供原生與 jQuery 兩個版本。
/**
* 以 document.write 寫入 js 或 css 標籤
* @param jsonData.path 前綴路徑
* @param jsonData.url 要載入的檔案路徑
* @param jsonData.type 'js' 或 'css'
*/
function loadWriteFiles(jsonData) {
jsonData.path = jsonData.path != undefined ? jsonData.path : "";
if (jsonData.type == "js") {
document.writeln("<script type='text/javascript' src='"+ jsonData.path + jsonData.url +"'></script>");
} else if (jsonData.type == "css") {
document.writeln("<link rel='stylesheet' href='"+ jsonData.path + jsonData.url +"' type='text/css' />");
}
}
/**
* 動態建立元素並掛到 head,支援載入完成回呼
*/
function loadFilesToHead(jsonData) {
jsonData.path = jsonData.path != undefined ? jsonData.path : "";
if (jsonData.type == "js") {
var _js = document.createElement("script");
_js.setAttribute("type", "text/javascript");
_js.setAttribute("src", jsonData.path + jsonData.url);
_js.onload = _js.onreadystatechange = function(){
if (!this.readyState || this.readyState == 'loaded' || this.readyState == 'complete') {
if ("function" == typeof(jsonData["callback"]) && jsonData["callback"]) {
jsonData["callback"].call(this);
}
}
_js.onload = _js.onreadystatechange = null;
};
document.getElementsByTagName("head")[0].appendChild(_js);
} else if (jsonData.type == "css") {
var _css = document.createElement("link");
_css.setAttribute("type", "text/css");
_css.setAttribute("rel", "stylesheet");
_css.setAttribute("href", jsonData.path + jsonData.url);
document.getElementsByTagName("head")[0].appendChild(_css);
}
}
利用 $.Deferred 可以讓多個檔案形成序列,前一個載完才載下一個,並統一用 Promise 拿結果:
var uiLoad = uiLoad || {};
(function($, $document, uiLoad) {
"use strict";
var loaded = [], promise = false, deferred = $.Deferred();
uiLoad.load = function (srcs) {
srcs = $.isArray(srcs) ? srcs : srcs.split(/\s+/);
if (!promise) { promise = deferred.promise(); }
$.each(srcs, function(index, src) {
promise = promise.then(function(){
return src.indexOf('.css') >= 0 ? loadCSS(src) : loadScript(src);
});
});
deferred.resolve();
return promise;
};
var loadScript = function (src) {
if (loaded[src]) return loaded[src].promise();
var deferred = $.Deferred();
var script = $document.createElement('script');
script.src = src;
script.onload = function (e) { deferred.resolve(e); };
script.onerror = function (e) { deferred.reject(e); };
$document.body.appendChild(script);
loaded[src] = deferred;
return deferred.promise();
};
var loadCSS = function (href) {
if (loaded[href]) return loaded[href].promise();
var deferred = $.Deferred();
var style = $document.createElement('link');
style.rel = 'stylesheet';
style.type = 'text/css';
style.href = href;
style.onload = function (e) { deferred.resolve(e); };
style.onerror = function (e) { deferred.reject(e); };
$document.head.appendChild(style);
loaded[href] = deferred;
return deferred.promise();
};
})(jQuery, document, uiLoad);
jQuery 版有兩個值得注意的地方:loaded 宣告為陣列卻用來存 Deferred 物件,語意上應該是物件或 Map;另外 deferred.resolve() 在迴圈外立刻呼叫,會讓最外層的 promise 提早完成,實際應該回傳最後串接出來的那個 promise。若要在新專案使用,直接用原生寫法即可:
function loadScript(src){
return new Promise(function(resolve, reject){
var s = document.createElement('script');
s.src = src;
s.onload = resolve;
s.onerror = reject;
document.head.appendChild(s);
});
}