yangyang b858679fbd 代码初始化		1 rok pred
..
LICENSE.md	b858679fbd 代码初始化	1 rok pred
README.md	b858679fbd 代码初始化	1 rok pred
color.js	b858679fbd 代码初始化	1 rok pred
color.min.js	b858679fbd 代码初始化	1 rok pred
css.color.js	b858679fbd 代码初始化	1 rok pred
css.color.min.js	b858679fbd 代码初始化	1 rok pred

color.js

Version 0.2.1.2

Create and manipulate colors with ease.

Examples

Making violet (#EE82EE):

Color.get("violet")
Color(0xEE82EE)
Color("#EE82EE")
Color("EE82EE")
Color(0xEE, 0x82, 0xEE)
Color("EE", "82", "EE")
Color(238, 130, 238)
Color.rgb(238, 130, 238)
Color.hsl(0.8333333333333334, 0.7605633802816902, 0.7215686274509804)
// 300°, 75.88652482269505%, 72.35294117647058%

Shorthand color notation:

Color("#ABC") // "#AABBCC"
Color("ABC")  // "#AABBCC"

Convert a hex color to RGBA:

var c = new Color('#ABC123', 0.6);
c.getRGBA(); // rgba(171,193,35,0.6)

`setValue` and `channels`

var myColor = new Color;
myColor.setValue(0xAA7F00);
myColor.hexTriplet() === "#aa7f00";
myColor.channels[0] = 0xFF;
myColor.hexTriplet() === "#ff7f00"; // orange

Defining a custom color:

Color.define("rind", [92, 163, 16])
Color.get("rind").hexTriplet() === "#5ca310"

Get a random color between green and blue

Color.random("green", "blue");

Parsing CSS color values

red   = Color.parse("rgb(255, 0, 0)");
green = Color.parse("rgb ,128"); // shorthand
blue  = Color.parse("hsl(240, 100%, 50%)");

red.hexTriplet()   === "#ff0000";
green.hexTriplet() === "#008000";
blue.hexTriplet()  === "#0000ff";

Supported Browsers

Firefox 1+
Safari 2+
IE 6+
Opera 7+
Google Chrome 0.1+

Usage

color.js can be used in any ECMAScript environment as it does not make use of the DOM. color.js is very useful on the server-side and the client-side.

color.js CSS Module

The color.js CSS module defines all of the standard CSS colors for use in color.js.

API

Note: HSL values are in the form of fractions (0 to 1). A hue value of 0.5 is equivalent to a hue of 180°.

Instantiation

Color objects can be instantiated in any of the following ways:

color = [new ]Color(color:int | string, [, alpha:float])
color = [new ]Color(red:int | string, green:int | string, blue:int | string [, alpha:float | string])
color = Color.rgb(red:int, green:int, blue:int [, alpha:float])
color = Color.hsl(hue:float, saturation:float, lightness:float [, alpha:float])

Instance methods and properties

channels : array: An array containing a color's red, green, blue, and alpha channels in that order.
rgb(): Returns a CSS rgb() function representing the color.
rgba(): Returns a CSS rgba() function representing the color.
hsl(): Returns a CSS hsl() function representing the color.
hsla(): Returns a CSS hsla() function representing the color.
css(): If the alpha channel is 1, this returns hexTriplet(). Otherwise, this returns rgba().
getValue() and valueOf(): Returns an integer representation of the color.
setValue(value:int): Sets the to value.
hexTriplet(): Returns the hex triplet (#RRGGBB) representation of the color.
rgbData(): Returns an array containing the color's red, green, and blue channels in that order.
hslData(): Returns an array containing the color's hue, saturation, and lightness channels in that order.
toString(): Returns this[Color.TO_STRING_METHOD]().

Constructor methods

Color names are case-insensitive.

Color.define(colorName:string, RGB:array | string): Saves the specified RGB color under colorName, for later retrieval.
Color.get(colorName:string): Returns a new color instance instance using the RGB data from a previously defined color with the name, colorName.
Color.del(colorName:string): Deletes a previously defined color with the name of colorName.
Color.clearColors(): Clears all color definitions.
Color.parse(cssFunction:string): Returns the color represented by a CSS function (eg. hsl(0, 100%, 50%)) or hex triplet. If no color could be parsed, this returns null. This function intentionally allows invalid syntax when parsing css functions. As long as the first three non-whitespace characters (case-insensitive) are "rgb" or "hsl" and the arguments (which are all optional and default to zero) are separated by commas, this function will be able to parse the CSS function.
Color.random([rangeStart:int | string] [, rangeEnd:int | string]): Returns a random color from rangeStart to rangeEnd. If rangeStart is not specified, this returns a random color from #000000 to #FFFFFF. rangeStart and rangeEnd can also be color names.
Color.rgb(red:int, green:int, blue:int [, alpha:float]): Returns a color constructed from the specified RGB values.
Color.hsl(hue:float, saturation:float, lightness:float [, alpha:float]): Returns a color constructed from the specified HSL values.
Color.RGBtoHSL(rgb:array): Returns the array of RGB values converted to HSL values.
Color.HSLtoRGB(hsl:array): Returns the array of HSL values converted to RGB values.

Configuration properties

Color.TO_STRING_METHOD : string

README.md