https://github.com/sterlingwes/randomcolor
Javascript module for generating random, distinguishable, pleasing colors (ie: for chart series).
https://github.com/sterlingwes/randomcolor
chart colors colour colours javascript random series
Last synced: about 1 year ago
JSON representation
Javascript module for generating random, distinguishable, pleasing colors (ie: for chart series).
- Host: GitHub
- URL: https://github.com/sterlingwes/randomcolor
- Owner: sterlingwes
- License: mit
- Created: 2012-09-15T17:02:06.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2023-03-03T11:00:08.000Z (over 3 years ago)
- Last Synced: 2025-03-16T00:25:29.664Z (over 1 year ago)
- Topics: chart, colors, colour, colours, javascript, random, series
- Language: JavaScript
- Homepage: http://sterlingwes.github.io/RandomColor
- Size: 863 KB
- Stars: 91
- Watchers: 3
- Forks: 12
- Open Issues: 11
-
Metadata Files:
- Readme: Readme.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Random Color
[](https://coveralls.io/github/sterlingwes/RandomColor?branch=master)
Random color is a simple javascript module for generating random colors that contrast enough to distinguish between one another, and are not too loud (by default, all colours can have readable black/dark font overlayed).
[Example](https://cdn.rawgit.com/sterlingwes/RandomColor/5a65e8ff/example/index.html)
Useful, for example, in charts and diagrams where X number of series need to be distinguished by color.
[See changelog](/CHANGELOG.md).
## Getting it
### Node.js
`npm install rcolor`
### Browser
Clone this repo / copy `dist/rcolor.min.js`
*Note* that the `dist/rcolor.js` file is a CommonJS export (the node.js build)
## Using it
With the browser build:
```javascript
window.rcolor()
// > "#79f2ab"
```
With the node build:
```javascript
const rcolor = require('rcolor')
rcolor() // "#79f2ab"
```
This module holds the initial random number seed as internal state. To regenerate the random number seed, call the `reSeed` method: `rcolor.reSeed()`.
## Options / Configuration
You can specify the `hue`, `saturation` and `value`. The following are the defaults:
```javascript
const goldenRatio = 0.618 // ... truncated
rcolor({
hue: (Math.random() + goldenRatio) % 1,
saturation: 0.5,
value: 0.95
})
```
## Pre-v1.0
If you used this module prior to NPM availability (between 2013 and 2017), you can find that source (including the Dart version) on the [legacy branch](https://github.com/sterlingwes/RandomColor/tree/legacy).
## License
Free to use and distribute under the MIT license.
## Sorry, Colour
Apologies in advance to my commonwealth friends, if you find 'color' vs. 'colour'. It was a hard decision for a Canadian. :)
Wes Johnson
[@SterlingWes](http://twitter.com/SterlingWes)