Rust CSS Color Parser Library

Rust library to parse CSS color string as defined in the W3C's CSS Color Module Level 4.

Supported Color Format

• Named colors
• RGB hexadecimal (with and without # prefix)
  • Short format #rgb
  • Short format with alpha #rgba
  • Long format #rrggbb
  • Long format with alpha #rrggbbaa
• rgb() and rgba()
• hsl() and hsla()
• hwb()
• hwba(), hsv(), hsva() - not in CSS standard.

Not yet supported: lab(), lch().

Example Color Format

```text transparent gold rebeccapurple lime

0f0

0f0f

00ff00

00ff00ff

rgb(0,255,0) rgb(0% 100% 0%) rgb(0 255 0 / 100%) rgba(0,255,0,1) hsl(120,100%,50%) hsl(120deg 100% 50%) hsl(-240 100% 50%) hsl(-240deg 100% 50%) hsl(0.3333turn 100% 50%) hsl(133.333grad 100% 50%) hsl(2.0944rad 100% 50%) hsla(120,100%,50%,100%) hwb(120 0% 0%) hwb(480deg 0% 0% / 100%) hsv(120,100%,100%) hsv(120deg 100% 100% / 100%) ```

Usage

Add this to your Cargo.toml

toml csscolorparser = "0.5.0"

Examples

Using csscolorparser::parse() function.

```rust let c = csscolorparser::parse("rgb(100%,0%,0%)")?;

asserteq!(c.rgba(), (1., 0., 0., 1.)); asserteq!(c.rgbau8(), (255, 0, 0, 255)); asserteq!(c.tohexstring(), "#ff0000"); asserteq!(c.torgb_string(), "rgb(255,0,0)"); ```

Using parse() method on &str.

```rust use csscolorparser::Color;

let c = "#ff00007f".parse::()?;

asserteq!(c.rgbau8(), (255, 0, 0, 127)); asserteq!(c.tohex_string(), "#ff00007f"); ```

Default Feature

• named-colors: Enables parsing from named colors. Requires phf.

Optional Features

• rust-rgb: Enables converting from rgb crate types into Color.
• cint: Enables converting cint crate types to and from Color.
• serde: Enables serializing (into HEX string) and deserializing (from any supported string color format) using serde framework.

Similar Projects

• csscolorparser (Go)
• csscolorparser (Javascript)