有些共用資源(例如某支圖表庫、某頁才用得到的樣式)不必在頁面載入時就全部拉下來,改成「需要時才載入」可以省下初始負載。以下整理兩種做法,並說明原始寫法中兩個會出問題的地方。
// 使用方式:
// $.include('file/ajaxa.js');
// $.include('file/ajaxa.css');
// 或者(當 .js 與 .css 在同一個目錄時)
// $.includePath = 'file/';
// $.include(['ajaxa.js', 'ajaxa.css']);
$.extend({
includePath: '',
include: function (file) {
var files = typeof file == "string" ? [file] : file;
for (var i = 0; i < files.length; i++) {
var name = files[i].replace(/^\s|\s$/g, "");
var att = name.split('.');
var ext = att[att.length - 1].toLowerCase();
var isCSS = ext == "css";
var tag = isCSS ? "link" : "script";
var attr = isCSS
? " type='text/css' rel='stylesheet' "
: " type='text/javascript' ";
var link = (isCSS ? "href" : "src") + "='" + $.includePath + name + "'";
// 已經載入過就跳過,避免重複
if ($(tag + "[" + link + "]").length == 0) {
$("head").prepend("<" + tag + attr + link + "></" + tag + ">");
}
}
}
});
$.include('../js/jquery-ui-1.8.21.custom.min.js');
$.include('../css/black-tie/jquery-ui-1.8.21.custom.css');
把這段放進一支 common.js,於頁面中載入它,之後隨時都能呼叫 $.include() 動態補充資源。
原始寫法在組 script 標籤時加上了 language='javascript':
var attr = isCSS ? " type='text/css' rel='stylesheet' "
: " language='javascript' type='text/javascript' ";
但 HTML5 已經不支援 script 的 language 屬性,寫了不但沒意義,還會讓文件無法通過驗證,所以把它刪掉,只留 type。
原始寫法是:
document.write("<" + tag + attr + link + "></" + tag + ">");
實測會發現一個嚴重問題:document.write() 在文件載入完成之後呼叫,會先清空整個頁面再寫入,等於把原本的內容全部覆蓋掉。這完全不是我們要的行為——我們只想在既有頁面上「追加」資源。查過 API 後改用:
$("head").prepend("<" + tag + attr + link + "></" + tag + ">");
$("head").prepend() 會把內容插到 head 的最前面,既不影響既有元素,也能確保載入的樣式有合理的優先序。
如果不依賴 jQuery,用標準 DOM 方法其實更直觀,也更容易理解背後發生的事:
function loadjscssfile(filename, filetype) {
if (filetype == "js") { // 外部 JavaScript
var fileref = document.createElement('script');
fileref.setAttribute("type", "text/javascript");
fileref.setAttribute("src", filename);
} else if (filetype == "css") { // 外部 CSS
var fileref = document.createElement("link");
fileref.setAttribute("rel", "stylesheet");
fileref.setAttribute("type", "text/css");
fileref.setAttribute("href", filename);
}
if (typeof fileref != "undefined") {
document.getElementsByTagName("head")[0].appendChild(fileref);
}
}
loadjscssfile("myscript.js", "js"); // 動態載入 JS
loadjscssfile("javascript.php", "js"); // 把 PHP 輸出當 JS 載入
loadjscssfile("mystyle.css", "css"); // 動態載入 CSS
原理一句話講完:用 DOM 方法造出一個新的 script 或 link 元素、設定屬性、再用 appendChild 掛進文件樹。聽起來花俏,實際就這三步。
動態載入的 script 是非同步的。它不會阻塞後續程式碼,所以不能保證「呼叫完下一行就一定載入好了」。若需要確保順序,得改用 onload 回呼,或動態插入一個 Promise 來串接。
去重複判斷值得保留。示範中先查同屬性的標籤是否已存在,能避免重複引入同一支檔案——这在單頁應用裡切換視圖時特別容易發生。
更現代的方案是動態 import。原生 import('./module.js').then(...) 已經是標準語法,能處理快取、錯誤與模組作用域,比手刻標籤可靠得多。若只是為了載入 CSS,也可以考慮 <link rel="preload"> 搭配 media 屬性的技巧。