postcss-url ![Build Status](https://travis-ci.org/postcss/postcss-url.png)
PostCSS plugin to rebase or inline on url().
Installation
$ npm install postcss-url
Usage
var fs = require("fs")
var postcss = require("postcss")
var url = require("postcss-url")
var css = fs.readFileSync("input.css", "utf8")
var output = postcss()
.use(url({
url: "rebase"
}))
.process(css, {
from: "src/stylesheet/index.css"
to: "dist/index.css"
})
.css
Checkout tests for examples.
Options
url
(default: "rebase"
)
url: "rebase"
Allow you to fix url()
according to postcss to
and/or from
options (rebase to to
first if available, otherwise from
or process.cwd()
).
url: "inline"
Allow you to inline assets using base64 syntax. Can use postcss from
option to find ressources.
url: {Function}
Custom transform function. Takes one argument (original url) and should return the transformed url.
You can use this option to adjust urls for CDN.
maxSize: "size in kbytes"
Specify the maximum file size to inline
basePath: "basePath for images to inline"
Specify the basePath from where to search images
Contributing
Work on a branch, install dev-dependencies, respect coding style & run tests before submitting a bug fix or a feature.
$ git clone https://github.com/postcss/postcss-url.git
$ git checkout -b patch-1
$ npm install
$ npm test