CSS URL 工具

319 查看

有许多原因使得你需要在CSS代码中系统性的替代URL：将其转换为数据URI、将其指向一个CDN、将其文件名替换为自动生成的文件名，等等。这个工具能够帮你从给定的CSS代码中将URL解析出来，并允许你将其替换为你选择的任意值。替换后的CSS代码与源代码完全相同，除了URL已经根据你的选择进行了替换。

这个库包含诸多工具，能够帮助你操作和更改CSS URL。

CSS URL重写器（Rewriter）

CSS URL重写器使用一个CSS分词器来安全的找到所有的CSS URL，这使得所有的改动都是完全安全的，因为它不依赖于正则表达式从CSS中提取URL。

使用方法

var URLRewriter = require("cssurl").URLRewriter;

var rewriter = new URLRewriter(function(url) {

// automatically append a query string with a unique value to bust caches

return url + "?v=" + Date.now();

});

var result = rewriter.rewrite(cssCode);

当CSS URL重写器遍历CSS代码时，它会调用传入CSSURLRewriter构造器的函数，并传给它找到的每个URL。url变量是指CSS代码中找到的除去了任何引号和前后空格的URL（不包含url()）。之后，你可以检查URL，随心所欲地修改它，以及在你需要使用的地方返回它的值。

限制

CSS URL重写器只会替换被表示为URL标记的URL，也就是说，它必须是以url(foo.css)的形式而非”foo.css”的形式存在，尽管后者在部分CSS里是允许的。

CSS URL重写流（Rewrite Stream）

CSS URL重写流使用流内部的URL重写器，因此你可以很容易将代码取出或置入。

使用方法

var URLRewriteStream = require("cssurl").URLRewriteStream;

fs.createReadStream("my.css").pipe(new URLRewriteStream(function(url) {

// automatically append a query string with a unique value to bust caches

return url + "?v=" + Date.now();

})).pipe(fs.createWriteStream("my-new.css"));

CSS URL翻译器（Translator）

CSS URL翻译器是一个工具，能够对不同CSS文件中的相关CSS URL进行翻译。有时候你可能要移动一个CSS文件，比如说从css/sprites/foo.css到css/sprites.css，当你做这件事时，CSS文件中任何相关的URL都不再准确了。CSS URL翻译器，与CSS URL重写器结合使用，通过自动计算出新的路径使得我们可以轻松地进行修改。翻译器也足够聪明，不会翻译任何不相关的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"

开发

要运行测试，请克隆以下仓库，然后执行：

1 2	$ npm i $ npm test

版权和许可证为BSD3