PostCSS plugin to transform W3C CSS color function to more compatible CSS.
$ npm install postcss-color-function
// dependencies
var fs = require("fs")
var postcss = require("postcss")
var colorFunction = require("postcss-color-function")
// css to be processed
var css = fs.readFileSync("input.css", "utf8")
// process css
var output = postcss()
.use(colorFunction())
.process(css)
.css
Using this input.css
:
body {
background: color(red a(90%))
}
you will get:
body {
background: rgba(255, 0, 0, 0.9)
}
Checkout tests for examples.
color( [ <color> | <hue> ] <color-adjuster>* )
[red( | green( | blue( | alpha( | a(] ['+' | '-']? [<number> | <percentage>] )
[red( | green( | blue( | alpha( | a(] '*' <percentage> )
@todorgb( ['+' | '-'] [<number> | <percentage>]{3} )
@todorgb( ['+' | '-'] <hash-token> )
@todorgb( '*' <percentage> ) |
[hue( | h(] ['+' | '-' | '*']? <angle> )
[saturation( | s(] ['+' | '-' | '*']? <percentage> )
[lightness( | l(] ['+' | '-' | '*']? <percentage> )
[whiteness( | w(] ['+' | '-' | '*']? <percentage> )
[blackness( | b(] ['+' | '-' | '*']? <percentage> )
tint( <percentage> )
shade( <percentage> )
blend( <color> <percentage> [rgb | hsl | hwb]? )
@todoblenda( <color> <percentage> [rgb | hsl | hwb]? )
contrast( <percentage>? )
Notes:
- some adjusts have shortcuts,
- can be used on every value on any property,
- some values can use add/subtract/scale modifiers or a direct value.
Read the specs for more information.
whatever {
color: color(red a(10%));
background-color: color(red lightness(50%)); /* == color(red l(50%)); */
border-color: color(hsla(125, 50%, 50%, .4) saturation(+ 10%) w(- 20%));
}
No we cannot do that. currentcolor
depends on the cascade (so the DOM) and we can't handle that in a simple preprocessing step. You need to handle that with polyfills.
By using postcss-custom-properties before this plugin, you can do that (sort of). You have some examples in cssnext playground.
lighten
and darken
are Sass specific methods and not supported by native CSS specs. The same functionality can be achieved with the tint and shade adjusters:
$lighten(red, 20%)
/* is equivalent to */
color(red tint(20%))
$darken(red, 20%)
/* is equivalent to */
color(red shade(20%))