Color code a value within a numerical range.
All colors are customizable, but defaults to a linear gradient between red (
Install the gem and add to the application's Gemfile by executing:
$ bundle add number_to_color
If bundler is not being used to manage dependencies, install the gem by executing:
$ gem install number_to_color
-
value: The numerical value to color code for. -
domain: The numerical domain, or "range", for the color gradient. This can be a 2 or 3-item array. In a 3-item array, you can set the midpoint to be anywhere between the first and last item (e.g.,[0, 5, 7]). The midpoint defaults to white. -
neutral_color/positive_color/negative_color: (optional) Custom colors that can be passed in to override the defaults. These can be hex or RGB codes.
To get started, require the gem in your file.
require 'number_to_color'
ColorCode.new(value: 2, domain: [1, 2, 3]).to_hex
// #ffffff (neutral color)
ColorCode.new(value: 5, domain: [1, 5, 7]).to_hex
// #ffffff (neutral color)
ColorCode.new(value: 1, domain: [7, 3.5, 1]).to_hex
// #0ea5e9 ("good" color)
ColorCode.new(value: 1, domain: [0, 1], positive_color: '#ffffff").to_hex
// #ffffff (our new "positive" color)
After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/nonlocalize/number_to_color.
The gem is available as open source under the terms of the MIT License.