需要依條件載入額外的程式或樣式時,動態插入 script 與 link 標籤是最通用的做法。以下從最省事到最完整,整理幾種實作方式。
$.getScript("test.js");
一行搞定,但如另一篇所述,它預設不共用快取且會附加 timestamp,對效能與網址比對都不利。
function loadjs(file){
var head = $('head').remove('#loadscript');
$("<scri"+"pt></scr"+"ipt>").attr({ src: file, type: 'text/javascript', id: 'load' }).appendTo(head);
}
這裡有兩個細節。remove('#loadscript') 先清掉舊的節點,避免重複載入;而標籤名稱拆成 "<scri"+"pt>" 這種看似奇怪的寫法,是因為在 HTML 頁面中直接寫 "</script>" 字串會被瀏覽器的解析器誤判為 script 區塊的結束標籤,導致整段程式碼被截斷。拆開拼接是最簡單的迴避手法。
$("<scri"+"pt></scr"+"ipt>").attr({ src: file, type: 'text/javascript', id: 'load' }).appendTo($('head').remove('#loadscript'));
邏輯與方法二相同,只是全部串成一條鏈式呼叫。適合放進工具函式庫,但不利閱讀。
以下程式碼取自 news.qq.com 的頁面,示範如何在不依賴 jQuery 的情況下,於網頁底部動態把 JS 掛到 <head> 之後。它的可貴之處在於加上了逾時偵測:
<script>
var SCRIPT_TIMEOUT = 20000;
var QVPL_PATH = "/QVPL1.0.0.js";
function loadHelper (jsurl) {
var oScriptEl, oTimeoutHDL;
oScriptEl = document.createElement("script");
oScriptEl.type = "text/javascript";
oScriptEl.language = "javascript";
oScriptEl.src = jsurl;
oScriptEl.onreadystatechange = doCallback;
oScriptEl.onload = function(){
this.readyState = "complete";
doCallback();
if (typeof(lianbo) == "object") {
lianbo.init(window.QVPL);
}
};
oTimeoutHDL = window.setTimeout(doError, SCRIPT_TIMEOUT);
document.getElementsByTagName("head")[0].appendChild(oScriptEl);
function doCallback() {
if (oScriptEl.readyState == "complete" || oScriptEl.readyState == "loaded") {
oScriptEl.onload = oScriptEl.onreadystatechange = new Function();
window.clearTimeout(oTimeoutHDL);
}
};
function doError() {
oScriptEl.parentNode.removeChild(oScriptEl);
};
}
loadHelper(QVPL_PATH);
</script>
這段程式碼有三個值得學的地方。
第一,onload 與 onreadystatechange 同時掛上。前者是標準事件,後者是舊版 IE 的作法,兩者並存才能跨瀏覽器相容。
第二,逾時機制。它設了一個 20 秒的計時器,若腳本遲遲未載入完成,就把 script 節點從 DOM 中移除。doCallback 裡的 clearTimeout 則在成功時取消這個計時器。少了這層設計,一旦 CDN 掛了,使用者只會遇到一個永遠不會執行的回調,且無從得知原因。
第三,回調完成後把 onload 與 onreadystatechange 設為 new Function(),等於清空處理函式。這能避免重複觸發,也讓 script 元素可被回收。
樣式表的載入方式類似,只是換成 link 元素:
function loadcss(href){
var link = document.createElement("link");
link.rel = "stylesheet";
link.type = "text/css";
link.href = href;
document.getElementsByTagName("head")[0].appendChild(link);
}
要注意 link 元素的 onload 在舊版瀏覽器上支援不佳,若必須確認樣式已套用,實務上常見的做法是在載入後檢查某個測試元素的 computed style 是否改變。
今天的專案幾乎都會經過打包工具(Vite、webpack 等),動態載入改用 import() 語法即可,打包器會自動處理程式碼分割與快取:
import('./module.js').then(mod => mod.init());
CSS 也可以直接 import './style.css',由打包器決定注入方式。手寫的动态載入主要還是在製作需嵌入第三方頁面的 widget、或在没有构建流程的 legacy 專案中才有必要。