postcss-color-rgba-fallback
Version:
PostCSS plugin to transform rgba() to hexadecimal
105 lines (71 loc) • 2.04 kB
Markdown
# postcss-color-rgba-fallback [](https://travis-ci.org/postcss/postcss-color-rgba-fallback)
> [PostCSS](https://github.com/postcss/postcss) plugin to transform rgba() to hexadecimal.
## Installation
```bash
$ npm install postcss-color-rgba-fallback
```
## Usage
```js
// dependencies
var fs = require("fs")
var postcss = require("postcss")
var colorRgbaFallback = require("postcss-color-rgba-fallback")
// css to be processed
var css = fs.readFileSync("input.css", "utf8")
// process css
var output = postcss()
.use(colorRgbaFallback())
.process(css)
.css
```
Using this `input.css`:
```css
body {
background: rgba(153, 221, 153, 0.8);
border: solid 1px rgba(100,102,103,.3);
}
```
you will get:
```css
body {
background: #99DD99;
background: rgba(153, 221, 153, 0.8);
border: solid 1px #646667;
border: solid 1px rgba(100,102,103,.3);
}
```
## Node.js options
postcss-color-rgba-fallback accepts options
### `properties`
default: `
[ "background-color",
"background",
"color",
"border",
"border-color",
"outline",
"outline-color ]
`
Allows you to specify your whitelist of properties.
**This option enables adding a fallback for one or a properties list**
### `oldie`
default: `false`
Set to true to enable the option and to get fallback for ie8
### `backgroundColor`
default: `null`
Allows you to specify a background color to use as a base alpha matte.
Instead of cutting off the alpha channel it will blend the foreground and background.
Expects an array of rgb values:
```js
"backgroundColor": [255, 1, 1]
```
Checkout [tests](test) for more examples.
---
## 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-color-rgba-fallback.git
$ git checkout -b patch-1
$ npm install
$ npm test
## [Changelog](CHANGELOG.md)
## [License](LICENSE)