chart

See an example on heroku (Example Source Code)

Chart ships with the following awesome charts:

• ChartJS (1.1.1 & 2.2.1) Note: chart.js and Chart2.js are not compatible
• NVD3 (1.8.2)
• Google Chart
• Highchart (4.2.5)

Chart

The motivation for making chart

I was reading up on rails engine and decided to test out my new knowledge by making a gem. As my previous project involves making multiple charts, I understand the pain of having duplicate data structure and functions in javascript and ruby just for the different charts.

Chart is my solution to quickly add Javascript/HTML chart into rails. You can write coffeescript/javascript to further interact with the rendered chart. Chart is inspired by another awesome gem chartkick

The limitation of chart is that it generates in-line javascript and it does not aim to be a 100% wrapper for all chart.

Chart works with Sprockets and your asset pipeline.

Several flavours to choose from.

ChartJS (MIT License)

• Bar Chart <%= bar :id_of_your_chart, size, data %>
• Line Chart <%= line :id, size, data %>
• Pie Chart <%= pie :id, size, data %>
• Radar Chart <%= radar :id, size, data %>

NVD3 (MIT License)

• Box Plot <%= boxplot :id, size, data %>
• Discrete Bar <%= discrete_bar :id, size, data %>
• Horizontal Grouped Bar <%= horizontal_grouped_bar :id, size, data %>

Google Chart (Open Source)

• Bar Chart <%= gBar :id, size, data %>
• Line Chart <%= gLine :id, size, data %>
• Pie Chart <%= gPie :id, size, data %>

Highchart (Free for Personal usage but paid for Commercial)

• Bar Chart <%= hBar %>
• Line Chart <%= hLine %>
• Pie Chart <%= hPie %>
• Area Chart <%= hArea %>

Installation

Add this line to your application's Gemfile:

gem 'chart'

At Application.js, write //= require chart after turbolinks. Only require the chart if you need them.

//= require turbolinks
//= require chart
//= require chart2 (not compatible with chart 1.1.1)
//= require nvd3
//= require google
//= require highcharts

At Application.css, write *= require nvd3

*= require_tree .
*= require nvd3

Example Usage

At your View

<%= pie :pie_chart, @pieSize, @pieData%>

At your Controller

@pieSize = {
    :height => 500,
    :width => 500
  }

  @pieData = [
        {
          value: 300,
          color:"#F7464A",
          highlight: "#FF5A5E",
          label: "Red"
        },
        {
          value: 50,
          color: "#46BFBD",
          highlight: "#5AD3D1",
          label: "Green"
        },
        {
          value: 100,
          color: "#FDB45C",
          highlight: "#FFC870",
          label: "Yellow"
        },
        {
          value: 40,
          color: "#949FB1",
          highlight: "#A8B3C5",
          label: "Grey"
        },
        {
          value: 120,
          color: "#4D5360",
          highlight: "#616774",
          label: "Dark Grey"
        }

      ].to_json

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake false 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 tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ytbryan/chart. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Contact

📮 Bryan Lim [e-mail]