Skip to content

arokettu/sass-hsv

Repository files navigation

sass-hsv

npm NPM Gitlab pipeline status

A simple helper to introduce HSV/HSB model support to SASS.

Usage

The helper tries to mimic hsl() syntax from css.

// adjust for your favorite importer
@use "~sass-hsv/hsv" as *;
@use "sass:list";

a {
    // the simplest
    color: hsv(270, 50%, 100%); // #bf7fff
    // use other angle units for h and unitless percents for s & v
    color: hsv(0.75turn 50 100); // #bf7fff, only with list syntax
    // use alpha channel
    color: hsv(270, 50%, 100%, 0.5); // rgba(191, 127, 255, 0.5)

    // aliases
    color: hsb(270, 50%, 100%); // same as hsv()
    color: hsva(270, 50%, 100%, 1); // same as hsv($h, $s, $v, $a) but alpha param is required
    color: hsba(270, 50%, 100%, 1); // same as hsva()
  
    // list syntax (since 2.0)
    color: hsv(270 50% 100%);
    color: hsv(270 50% 100% / 50%); // once it's available in sass
    color: hsv(list.slash(270 50% 100%, 50%)); // available today
}

Documentation

Read full documentation here: https://sandfox.dev/js/sass-hsv.html

Also on Read the Docs: https://sass-hsv.readthedocs.io/

Support

Please file issues on our main repo at GitLab: https://gitlab.com/sandfox/sass-hsv/-/issues

License

The library is available as open source under the terms of the MIT License.

About

A simple helper to introduce HSV/HSB model support to SASS

Topics

Resources

License

Stars

Watchers

Forks

Packages