postcss / postcss-color-function

PostCSS plugin to transform W3C CSS color function to more compatible CSS
MIT License
325 stars 31 forks source link

Better docs with examples #1

Open ai opened 9 years ago

ai commented 9 years ago

We should add better docs with examples for popular user cases like lighten/darken color. Now you need to open W3C spec and it is very bad for quick look. There is no examples or any way to find answer quickly.

For example, some people even think, that plugin didn’t support lighten :).

/cc @MoOx

MoOx commented 9 years ago

Most people don't look for before asking.

Anyway I've update the readme a little. Tell me if that enough.

ai commented 9 years ago

[lightness( | l(] ['+' | '-' | '*']? <percentage> ) is too complicated without examples :(. “lightness has a l alias” is better for first part of statement. What does * mean?

ai commented 9 years ago

blend( <color> <percentage> [rgb | hsl | hwb]? ) what is default value if I miss last arg? Also many people didn’t know hos blend depends on color mode.

ai commented 9 years ago

But now it is better :).

MadLittleMods commented 9 years ago

More examples would really clear things up :+1:

ghost commented 9 years ago

Need example of how to make this: scale-color($MYcolor, $saturation: +5%, $lightness: -16%);

And how to output Hex values.

9mm commented 9 years ago

background: color(var(--blue) lightness(5%));

Ser-Gen commented 8 years ago

You are repeatedly refer to the specification, but I don't see any link. Add it, please: https://drafts.csswg.org/css-color/#modifying-colors

MoOx commented 8 years ago

You can do it yourself. PR are always welcome.

Ser-Gen commented 8 years ago

Done: #20.