postcss-urlrewrite

PostCSS plugin for easy url() rewriting.

Getting Started

1npm install postcss-urlrewrite

Example

Usage example:

1// dependencies
2var fs = require( 'fs' );
3var postcss = require( 'postcss' );
4var urlrewrite = require( 'postcss-urlrewrite' );
5
6// css to be processed
7var css = fs.readFileSync( 'build/build.css', 'utf8' );
8
9// config for urlrewrite
10var config = {
11    imports: true,
12    properties: [ 'background', 'content' ],
13    rules: [
14        { from: \local\, to: 'global' },
15        { from: \local2\, to: 'global2' }
16    ]
17};
18
19// process css using postcss-urlrewrite
20var out = postcss()
21   .use( urlrewrite( config ) )
22   .process( css )
23   .css;

Configuration

imports

Type: boolean Default: false

If set to true will replace urls in @import at-rules.

properties

Type: array or boolean Default: true

List of css-properties to replace. If set to true, will work with all properties. If set to array will work only with the properties in the list.

rules

Type: array of objects or function

There is to way to set rules:

1. Create array of objects with "from" and "to" keys. "from" can be String or RegExp, "to" can be String or Function. See String.replace() syntax for details. ONLY first matching rule will be triggered on each URI.
2. Create function that will work with URIjs objects and mutate them one way or another.