做前端難免會遇到需要動態載入樣式表的情況,也就是在執行階段才把 <link> 標籤插進 head。常見場景包括依主題切換樣式、依裝置載入不同樣式檔等。以下整理三種實作方式。
如果專案裡已經有 jQuery,用起來相當簡潔:
var cssURL = '/style.css',
linkTag = $('<link href="' + cssURL + '" rel="stylesheet" type="text/css" media="' + (media || "all") + '" charset="' + charset || "utf-8" + '" />');
// 請看清楚,是動態將 link 標簽添加到 head 裡
$($('head')[0]).append(linkTag);
這段程式碼裡藏著一個優先級陷阱:'charset="' + charset || "utf-8" + '"'。由於 + 的優先級高於 ||,字串串接會先執行,結果永遠是一個非空字串(truthy),因此 || 右邊的預設值永遠不會生效。正確寫法應該把預設值處理提到前面:
charset = charset || "utf-8"; media = media || "all";
不想依賴 jQuery 的話,用標準 DOM API 一樣能做到:
var head = document.getElementsByTagName('head')[0],
cssURL = '/style.css',
linkTag = document.createElement('link');
linkTag.id = 'dynamic-style';
linkTag.href = cssURL;
linkTag.setAttribute('rel', 'stylesheet');
linkTag.setAttribute('media', 'all');
linkTag.setAttribute('type', 'text/css');
head.appendChild(linkTag);
關鍵在最後一步:建立元素只是把它放在記憶體裡,必須呼叫 appendChild 掛進文件,瀏覽器才會真的去下載並套用樣式。
舊版 IE 提供了一個更省事的方法:
var head = document.getElementsByTagName('head')[0],
cssURL = 'themes/BlueNight/style.css',
// document.createStyleSheet 的同時就已經把 link 標簽添加到了 head 中了,倒是挺方便
linkTag = document.createStyleSheet(cssURL);
createStyleSheet([sURL] [, iIndex]) 接受兩個參數:sURL 是 CSS 檔的網址路徑;iIndex 為選填,用來指定插入的 link 在頁面 stylesheets 集合中的索引位置,預設會附加到最後。這個 API 早已從標準中移除,僅供維護老系統時參考。
把上面的思路整理成可重複呼叫的函式:
function createLink(cssURL, lnkId, charset, media) {
var head = $($('head')[0]),
linkTag = null;
if (!cssURL) {
return false;
}
linkTag = $('<link href="' + cssURL + '" rel="stylesheet" type="text/css" media="' + (media || "all") + '" charset="' + charset || "utf-8" + '" />');
head.append(linkTag);
}
function createLink(cssURL, lnkId, charset, media) {
var head = document.getElementsByTagName('head')[0],
linkTag = null;
if (!cssURL) {
return false;
}
linkTag = document.createElement('link');
linkTag.setAttribute('id', (lnkId || 'dynamic-style'));
linkTag.setAttribute('rel', 'stylesheet');
linkTag.setAttribute('charset', (charset || 'utf-8'));
linkTag.setAttribute('media', (media || 'all'));
linkTag.setAttribute('type', 'text/css');
linkTag.href = cssURL;
head.appendChild(linkTag);
}
兩個版本都保留了 lnkId 參數,這其實是個實用的設計:有了 id,後續要移除或替換樣式時就能用 getElementById 精準找到它,避免多個動態樣式互相干擾。
注意載入時序。動態插入的 link 標籤是非同步載入的。程式碼執行完代表標籤已插入,但不代表樣式已經生效。若後續有程式依賴樣式計算結果(例如讀取元素寬高),需要監聽 link 元素的 onload 事件。
注意樣式的優先級。動態插入的樣式表位於文件末尾,同優先級下會蓋掉原本 head 中的規則。這通常是想要的效果,但若發現樣式莫名被覆寫,這就是原因。
如果只是想切換主題,其實更簡單的做法是预先在 head 中放好多組樣式表,透過修改 disabled 屬性來切換,完全不需要動態建立元素。