nonintanon / randomColor

A color generator for JavaScript.

Random Color

For generating attractive random colors. See the results on the demo.

Options

You can pass an options object to influence the type of color it produces. The options object accepts the following properties:

Hue – Controls the hue of the generated color. You can pass a string representing a color name (e.g. 'orange'). Possible color names are red, orange, yellow, green, blue, purple, pink and monochrome.

Luminosity – Controls the luminosity of the generated color. You can pass a string containing bright, light or dark.

Count – An integer which specifies the number of colors to generate.

Format – A string which specifies the format of the generated color. Possible values are hsvArray, rgb, rgbArray, and hex. The type of the generated color will vary based on the format chosen.

Examples

// Returns a hex code for an attractive color
randomColor(); 

// Returns an array of ten green colors
randomColor({
   count: 10,
   hue: 'green'
});

// Returns a hex code for a light blue
randomColor({
   luminosity: 'light',
   hue: 'blue'
});

// Returns a hex code for a 'truly random' color
randomColor({
   luminosity: 'random',
   hue: 'random'
});

// Returns a bright color in RGB
randomColor({
   luminosity: 'bright',
   format: 'rgb' // e.g. 'rgb(225,200,20)'
});

License

This project is licensed under the terms of the MIT license.