在實際專案中,你往往有各種理由需要系統性地替換 CSS 裡的 URL:把它轉成 Data URI、指向 CDN、或換成自動生成的檔名等等。本文介紹的這套工具,能從既有的 CSS 中解析出所有 URL,並讓你將它們替換成任何想要的值。替換後的 CSS 除了 URL 被改動外,其餘內容與原始碼完全一致。
這個函式庫集結了多個能操作與修改 CSS URL 的工具,以下逐一說明。
CSS URL Rewriter 採用的是一套 CSS 分詞器,而非正規表達式,因此能安全、精準地找出所有 CSS URL,改動過程完全不必擔心誤判。
使用方式如下:
var URLRewriter = require("CSSurl").URLRewriter;
var rewriter = new URLRewriter(function(url) {
// 自動附加帶有唯一值的查詢字串,用以破壞快取
return url + "?v=" + Date.now();
});
var result = rewriter.rewrite(CSSCode);
當重寫器遍歷 CSS 時,它會對找到的每一個 URL 呼叫傳入建構子的函式。傳入的 url 變數已去除引號與前後空白(但不含 url() 本身),你可以在其中自由檢查、修改,並回傳需要的值。
限制在於:它只會處理以 url(foo.css) 形式標示的 URL,而不會處理直接寫成 "foo.css" 的形式(儘管後者在部分 CSS 中也被允許)。
重寫串流在內部同樣使用 URL Rewriter,因此能輕鬆地從串流中讀取與寫入資料:
var URLRewriteStream = require("CSSurl").URLRewriteStream;
fs.createReadStream("my.CSS").pipe(new URLRewriteStream(function(url) {
// 自動附加帶有唯一值的查詢字串,用以破壞快取
return url + "?v=" + Date.now();
})).pipe(fs.createWriteStream("my-new.CSS"));
CSS URL Translator 能針對不同 CSS 檔案之間的相對路徑進行轉換。舉例來說,當你把一個檔案從 css/sprites/foo.css 移到 css/sprites.css 時,檔案中所有相對 URL 就都失效了。此工具能與 Rewriter 搭配使用,自動計算出路徑變化並完成修正,而且聰明到不會去動那些與搬移無關的 URL。
使用方式如下:
var URLTranslator = require("CSSurl").URLTranslator;
var translator = new URLTranslator();
var result = translator.translate("../../img/foo.png", "css/sprites/foo.CSS", "css/sprites.CSS");
console.log(result); // "../img/foo.png"
若要執行測試,請先複製這個儲存庫,然後依序執行:
$ npm i
$ npm test
版權與授權條款為 BSD3。