Skip to content

Renatello/randomColor

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Random Color

For generating attractive random colors. See the results on the demo. Available on cdnjs, npm and bower.

npm install randomcolor

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)'
});

Other languages

randomColor has been ported to c#, go and PHP.

License

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

To do

More generally, it might be a good idea to consider using other color models.

  1. When returning an array of multiple colors, try to make each color as distinct as possible. Make sure each color is distinct to its neighbours.
  2. Improve attractive dark color generation, currently they're a touch murky.
  3. Improve the color dictionary
  • definition of hue values and attractive luminosity bounds
  • think about how to store hue aliases (e.g. fuschia) or subranges (e.g teal)
  • think about making a little point and click tool for defining your own luminosity bounds and customizing the color dictionary
  1. Think about using and returning seeds.
  2. Think about adding feature to return complementary & contrasting colors, as well as color triads, tetrads etc. Other libraries might already do this better though.
  3. Think about adding a scheme options which would return a dominant color, as well as secondary, tertiary color and primary and secondary text colors. This might be a bad idea.

About

A color generator for JavaScript.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 78.7%
  • CSS 21.3%