colorsheet v1.0.5

colorsheet

colorsheet is a small library containing several functions for converting between color formats and calculating things like contrast and luminance.

usage:

npm i colorsheet

then (example):

const colorsheet = require('colorsheet')

const emerald = colorsheet.hexToRGBA("#50c878")
// returns {r: 80, g: 200, b: 120}

here's what it exposes:

const colorsheet = {
  shiftHue: shiftHue,
  hexToRGBA: hexToRGBA,
  calculateLuminance: calculateLuminance,
  hslToRGB: hslToRGB,
  rgbToHSL: rgbToHSL,
  rgbToNHSL: rgbToNHSL,
  rgbToHex: rgbToHex,
  getWcagLevels: getWcagLevels,
  getContrastRatio: getContrastRatio
};

functions

calculateLuminance(r, g, b) ⇒ number

calculateLuminance - color to calculate the luminance of an rgb color

kind: global function returns: number - luminance

hexToRGBA(hex) ⇒ object

hexToRGBA - converts hex colors to rgb(a) colors

kind: global function returns: object - rgb object with r, g, b and optionally a keys

rgbToHex(r, g, b) ⇒ string

rgbToHex - converts rgb color to hex color

kind: global function returns: string - string representing a hex color

hslToRGB(h, s, l) ⇒ object

hslToRGB - convert hsl color to rgb

kind: global function returns: object - rgb object with red, green, and blue keys

rgbToHSL(r, g, b) ⇒ object

rgbToHSL - convert rgb color to hsl color

kind: global function returns: object - object with h, s, and l keys

rgbToNHSL(r, g, b) ⇒ object

rgbToNHSL - rgb to number hsl - hsl with decimal / integer values instead of typical hsl notation

kind: global function returns: object - object containing hue, saturation, and lightness values

shiftHue(rgb, deg) ⇒ object

shiftHue - shifts the hue value of an rgb color

kind: global function returns: object - rgb object with red, green, and blue keys

getContrastRatio(hex1, hex2) ⇒ object

getContrastRatio - get the contrast rati between two colors

kind: global function returns: object - contrast ratio object with contrast ratio represented as a string and a decimal