前端常需要按需求 inject 資源:某個功能模組才載它的腳本、某個主題才載它的樣式。這裡整理兩套可直接複用的工具函式。
第一個版本用 document.write,只適合在頁面解析階段同步使用;第二個版本建立元素後掛進 head,並支援載入完成回呼,是比較實用的做法。
/**
* 以 document.write 輸出標籤(僅限頁面載入階段)
* @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,並在載入完成後執行 callback
*/
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 把多個檔案串成一條序列,並以快取表避免重複載入:
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,同樣的需求用 Promise 幾行就能寫完,還能直接用 async/await:
function loadScript(src) {
return new Promise((resolve, reject) => {
const s = document.createElement('script');
s.src = src;
s.async = true;
s.onload = resolve;
s.onerror = () => reject(new Error('載入失敗:' + src));
document.head.appendChild(s);
});
}
function loadCSS(href) {
return new Promise((resolve, reject) => {
const l = document.createElement('link');
l.rel = 'stylesheet';
l.href = href;
l.onload = resolve;
l.onerror = () => reject(new Error('載入失敗:' + href));
document.head.appendChild(l);
});
}
// 使用
await loadScript('/js/chart.min.js');
await loadCSS('/css/chart.css');
實務上仍要提醒:動態載入會讓依賴關係變得不明顯,除錯時要留意載入順序;同一資源重複 inject 也會造成多餘的網路請求,記得加上去重。