9.0 Released! → Native ESM runtimes 🚀, Vite support ⚡️, multi-window apps and more...
Read Announcement

Defined in: color/index.d.ts:4

Represents a color object. Stores all color components (alpha (opacity), red, green, blue) in a [0..255] range.

Constructors

Constructor

ts
new Color(knownColor: string): Color;

Defined in: color/index.d.ts:5

Parameters

ParameterType
knownColorstring

Returns

Color

Constructor

ts
new Color(hex: string): Color;

Defined in: color/index.d.ts:6

Parameters

ParameterType
hexstring

Returns

Color

Constructor

ts
new Color(argb: number): Color;

Defined in: color/index.d.ts:7

Parameters

ParameterType
argbnumber

Returns

Color

Constructor

ts
new Color(
   alpha: number, 
   red: number, 
   green: number, 
   blue: number, 
   type?: "rgb" | "hsl" | "hsv"): Color;

Defined in: color/index.d.ts:8

Parameters

ParameterType
alphanumber
rednumber
greennumber
bluenumber
type?"rgb" | "hsl" | "hsv"

Returns

Color

Properties

a

ts
a: number;

Defined in: color/index.d.ts:13

Gets the Alpha component (in the [0, 255] range) of this color. This is a read-only property.


android

ts
android: number;

Defined in: color/index.d.ts:48

Gets the android-specific integer value representation. Same as the Argb one. This is a read-only property.


argb

ts
argb: number;

Defined in: color/index.d.ts:38

Gets the Argb Number representation of this color where each 8 bits represent a single color component. This is a read-only property.


b

ts
b: number;

Defined in: color/index.d.ts:28

Gets the Blue component (in the [0, 255] range) of this color. This is a read-only property.


g

ts
g: number;

Defined in: color/index.d.ts:23

Gets the Green component (in the [0, 255] range) of this color. This is a read-only property.


hex

ts
hex: string;

Defined in: color/index.d.ts:33

Gets the Hexadecimal string representation of this color. This is a read-only property.


ios

ts
ios: any;

Defined in: color/index.d.ts:53

Gets the iOS-specific UIColor value representation. This is a read-only property.


name

ts
name: string;

Defined in: color/index.d.ts:43

Gets the known name of this instance. Defined only if it has been constructed from a known color name - e.g. "red". This is a read-only property.


r

ts
r: number;

Defined in: color/index.d.ts:18

Gets the Red component (in the [0, 255] range) of this color. This is a read-only property.

Methods

brighten()

ts
brighten(amount: number): Color;

Defined in: color/index.d.ts:172

Brighten the color a given amount, from 0 to 100.

Parameters

ParameterTypeDescription
amountnumber(between 0 and 100)

Returns

Color


complement()

ts
complement(): Color;

Defined in: color/index.d.ts:192

returns the color complement

Returns

Color


darken()

ts
darken(amount: number): Color;

Defined in: color/index.d.ts:179

Darken the color a given amount, from 0 to 100. Providing 100 will always return black.

Parameters

ParameterTypeDescription
amountnumber(between 0 and 100)

Returns

Color


desaturate()

ts
desaturate(amount: number): Color;

Defined in: color/index.d.ts:143

Desaturate the color a given amount, from 0 to 100. Providing 100 will is the same as calling greyscale.

Parameters

ParameterTypeDescription
amountnumber(between 0 and 100)

Returns

Color


equals()

ts
equals(value: Color): boolean;

Defined in: color/index.d.ts:59

Specifies whether this Color is equal to the Color parameter.

Parameters

ParameterTypeDescription
valueColorThe Color to test.

Returns

boolean


getBrightness()

ts
getBrightness(): number;

Defined in: color/index.d.ts:95

return the brightness

Returns

number


getLuminance()

ts
getLuminance(): number;

Defined in: color/index.d.ts:100

return the luminance

Returns

number


greyscale()

ts
greyscale(): Color;

Defined in: color/index.d.ts:157

Completely desaturates a color into greyscale. Same as calling desaturate(100).

Returns

Color


isDark()

ts
isDark(): boolean;

Defined in: color/index.d.ts:83

return true if brightenss < 128

Returns

boolean


isLight()

ts
isLight(): boolean;

Defined in: color/index.d.ts:89

return true if brightenss >= 128

Returns

boolean


lighten()

ts
lighten(amount: number): Color;

Defined in: color/index.d.ts:165

Lighten the color a given amount, from 0 to 100. Providing 100 will always return white.

Parameters

ParameterTypeDescription
amountnumber(between 0 and 100)

Returns

Color

olor : Color


saturate()

ts
saturate(amount: number): Color;

Defined in: color/index.d.ts:150

Saturate the color a given amount, from 0 to 100.

Parameters

ParameterTypeDescription
amountnumber(between 0 and 100)

Returns

Color


setAlpha()

ts
setAlpha(a: number): Color;

Defined in: color/index.d.ts:107

Return this color (as a new Color instance) with the provided alpha

Parameters

ParameterType
anumber

Returns

Color


spin()

ts
spin(amount: number): Color;

Defined in: color/index.d.ts:186

Spin the hue a given amount, from -360 to 360. Calling with 0, 360, or -360 will do nothing (since it sets the hue back to what it was before).

Parameters

ParameterTypeDescription
amountnumber(between 0 and 100)

Returns

Color


toHsl()

ts
toHsl(): {
  a: number;
  h: number;
  l: number;
  s: number;
};

Defined in: color/index.d.ts:112

return the hsl representation of the color

Returns

ts
{
  a: number;
  h: number;
  l: number;
  s: number;
}
a
ts
a: number;
h
ts
h: number;
l
ts
l: number;
s
ts
s: number;

toHslString()

ts
toHslString(): string;

Defined in: color/index.d.ts:118

return the CSS hsv representation of the color

Returns

string


toHsv()

ts
toHsv(): {
  a: number;
  h: number;
  s: number;
  v: number;
};

Defined in: color/index.d.ts:124

return the hsv representation of the color

Returns

ts
{
  a: number;
  h: number;
  s: number;
  v: number;
}
a
ts
a: number;
h
ts
h: number;
s
ts
s: number;
v
ts
v: number;

toHsvString()

ts
toHsvString(): string;

Defined in: color/index.d.ts:130

return the CSS hsv representation of the color

Returns

string


toRgbString()

ts
toRgbString(): string;

Defined in: color/index.d.ts:136

return the CSS rgb representation of the color

Returns

string


equals()

ts
static equals(value1: Color, value2: Color): boolean;

Defined in: color/index.d.ts:66

Compares two Color instances.

Parameters

ParameterTypeDescription
value1ColorA Color to compare.
value2ColorA Color to compare.

Returns

boolean


fromHSL()

ts
static fromHSL(
   a: any, 
   h: any, 
   s: any, 
   l: any): Color;

Defined in: color/index.d.ts:204

returns a new Color from HSL

Parameters

ParameterType
aany
hany
sany
lany

Returns

Color


fromHSV()

ts
static fromHSV(
   a: any, 
   h: any, 
   s: any, 
   l: any): Color;

Defined in: color/index.d.ts:205

Parameters

ParameterType
aany
hany
sany
lany

Returns

Color


fromIosColor()

ts
static fromIosColor(value: any): Color;

Defined in: color/index.d.ts:77

Creates color from iOS-specific UIColor value representation.

Parameters

ParameterType
valueany

Returns

Color


isValid()

ts
static isValid(value: any): boolean;

Defined in: color/index.d.ts:72

Validates if a value can be converted to color.

Parameters

ParameterTypeDescription
valueanyInput string.

Returns

boolean


mix()

ts
static mix(
   color1: Color, 
   color2: Color, 
   amount: number): Color;

Defined in: color/index.d.ts:198

returns the color complement

Parameters

ParameterType
color1Color
color2Color
amountnumber

Returns

Color