PillChart
¶ ↑
A simple rubygem for create little svg pill charts.¶ ↑
Like this :
Or without progression state :
It can be used alone, or in Rails (tested in 4.0.4) as a view helper.
Use it in Rails in 3 steps¶ ↑
-
Add
pill_chart
to your Gemfile (by adding this line:gem 'pill_chart', '~> 1.0.2'
) -
Run
bundle install
into your terminal, on your rails project directory -
Use the following methods directly into your views ! (Don’t forget to mark it as
html_safe
)
Helpers overview¶ ↑
# It will draw a simple pill, filled to `value`. draw_pill_chart(height: 10, width: 60, value: 33, max: 100, colors: {})
# It will draw a stated pill (the color changes with the value), filled to `value`. draw_state_pill_chart(height: 10, width: 60, value: 33, max: 100, colors: {})
Some examples¶ ↑
Draw a simple pill at 33% ( ) in a Rails view:
<%= draw_pill_chart(width: 60, value: 33).html_safe %>
——————————————– Draw a state pill at 70% ( ) in a Rails view:
<%= draw_state_pill_chart(width: 60, value: 70).html_safe %>
Available parameters¶ ↑
The max
parameter represents the maximum value. For example, a value of 60
and a max of 120
will fill the half of the pill.
You can pass custom colors in a hash to the colors
parameter. The color’s default values are :
colors = { "background" => "#eee", # the background colour "foreground" => "#999", # the pill color when it's a simple pill (not a state pill) "low" => "#AD6D6D", # the pill color under 20% when it's a state pill "medium" => "#C59663", # the pill color between 20 and 40% when it's a state pill "high" => "#ADC563", # the pill color between 40 and 70% when it's a state pill "full" => "#92C447" # the pill color between 70 and 100% when it's a state pill }
Use it without Rails¶ ↑
# Create a new SimplePillChart object, with theses parameters elt = PillChart::SimplePillChart.new(height, width, value, max, :simple, colors) # Run the pill method to generate the svg content elt.pill