0.0.14 • Published 6 years ago
culor v0.0.14
Culor
Just another color converter.
Installation
npm:
npm install culor
yarn:
yarn add culor
Usage example
import {color} from 'culor'
const color_name = color('red')
const color_hex = color('#ff5555')
const color_hex_short = color('#f55')
const color_rgb = color('rgb(255, 85, 85)')
const color_rgba = color('rgba(255, 85, 85, .7)')
const color_hsl = color('hsl(360deg, 100%, 67%)')
const color_hsla = color('hsla(400grad, 100%, 67%, .7)')
import {RGB, RGBA, HSL, HSLA} from 'culor'
const rgb = RGB('255', 85, 85)
const rgba = RGBA(255, '85', 85, .7)
const hsl = HSL(360, '100%', .67)
const hsla = HSLA('360deg', 1, '67%', .7)
const c = color('#00ff00ff')
c.Hex() // '#00ff00'
c.HexA() // '#00ff00ff'
c.RGB() // 'rgb(0, 255, 0)'
c.RGBA() // 'rgba(0, 255, 0, 1)'
c.HSL() // 'hsl(120, 100%, 50%)'
c.HSLA() // 'hsla(120, 100%, 50%, 1)'
c.keyword() // 'lime'
Syntax
color(csscolor)
RGB(R, G, B)
RGBA(R, G, B, A)
HSL(H, S, L)
HSLA(H, S, L, A)
Parameters
Key | Type | Value |
---|---|---|
csscolor | String | Color keywords, rgb(), rgba(), hsl(), hsla() or Hexadecimal notation in css data type. |
R | Number String | red, 0, 255 |
G | Number String | green, 0, 255 |
B | Number String | blue, 0, 255 |
H | String | hue angel |
S | Number String | saturation can be a number 0, 1, or a string between '0%' and '100%' |
L | Number String | lightness can be a number 0, 1, or a string between '0%' and '100%' |
A | Number String | alpha can be a number 0, 1, or a string between '0' and '1' |
Functions
Key | Type | Value |
---|---|---|
.Hex() | String | #RRGGBB |
.HexA() | String | #RRGGBBAA |
.RGB() | String | rgb(r, g, b) |
.RGBA() | String | rgba(r, g, b, a) |
.HSL() | String | hsl(h, s, l) |
.HSLA() | String | hsla(h, s, l, a) |
.keyword() | String | color keyword or undefined |
To-Do
- support rgb() / rgba() percentage unit.
- .Hex(A) .RGB(A) .HSL(A)
- HSLA2RGB -> HSL2RGB
- .keyword
Contributing
- Fork it
- Create your feature branch (
git checkout -b feature/fooBar
) - Commit your changes (
git commit -am 'Add some fooBar'
) - Push to the branch (
git push origin feature/fooBar
) - Create a new Pull Request