Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/michelson/lazy_high_charts

Make highcharts a la ruby , works in rails 5.X / 4.X / 3.X, and other ruby web frameworks
https://github.com/michelson/lazy_high_charts

Last synced: 1 day ago
JSON representation

Make highcharts a la ruby , works in rails 5.X / 4.X / 3.X, and other ruby web frameworks

Awesome Lists containing this project

README 

        
# LazyHighCharts



[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/michelson/lazy_high_charts?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)



This gem provides a simple and extremely flexible way to use HighCharts from ruby code.

Tested on Ruby on Rails, Sinatra and Nanoc, but it should work with others too. Highcharts is not free for commercial use, so make sure you have a valid license to use Highcharts.



[![Build Status](https://travis-ci.org/michelson/lazy_high_charts.png?branch=master)](http://travis-ci.org/michelson/lazy_high_charts)

[![Code Climate](https://codeclimate.com/github/michelson/lazy_high_charts.png)](https://codeclimate.com/github/michelson/lazy_high_charts)



[VERSION](https://github.com/michelson/lazy_high_charts/blob/master/GEM_VERSION)

[ChangeLog](https://github.com/michelson/lazy_high_charts/blob/master/CHANGELOG.md)



## Information



* RDoc documentation [available on RubyDoc.info](http://rubydoc.info/gems/lazy_high_charts/frames)

* Source code [available on GitHub](http://github.com/michelson/lazy_high_charts)

* More information, known limitations, and how-tos [available on the wiki](https://github.com/michelson/lazy_high_charts/wiki)



## Getting Help



* Please report bugs on the [issue tracker](http://github.com/michelson/lazy_high_charts/issues) but read the "getting help" section in the wiki first.



## Installation



### Installation with rubygems



To install it, you just need to add it to your Gemfile:



```ruby

gem 'lazy_high_charts'

```

edge version on trial

```ruby

gem 'lazy_high_charts' --pre

```



then run



```bash

bundle install

```



and make sure to get the latest version (unless you'd like an older version for some reason)

```bash

rake highcharts:update

```



and add this in the application.js



```js

//= require jquery

//= require jquery_ujs

//= require_tree .

//= require turbolinks



//= require highcharts/highcharts

//= require highcharts/highcharts-more

//= require highcharts/highstock

```



to install it.



## Usage:



### Controller code:

```ruby

@chart = LazyHighCharts::HighChart.new('graph') do |f|

  f.title(text: "Population vs GDP For 5 Big Countries [2009]")

  f.xAxis(categories: ["United States", "Japan", "China", "Germany", "France"])

  f.series(name: "GDP in Billions", yAxis: 0, data: [14119, 5068, 4985, 3339, 2656])

  f.series(name: "Population in Millions", yAxis: 1, data: [310, 127, 1340, 81, 65])



  f.yAxis [

    {title: {text: "GDP in Billions", margin: 70} },

    {title: {text: "Population in Millions"}, opposite: true},

  ]



  f.legend(align: 'right', verticalAlign: 'top', y: 75, x: -50, layout: 'vertical')

  f.chart({defaultSeriesType: "column"})

end



@chart_globals = LazyHighCharts::HighChartGlobals.new do |f|

  f.global(useUTC: false)

  f.chart(

    backgroundColor: {

      linearGradient: [0, 0, 500, 500],

      stops: [

        [0, "rgb(255, 255, 255)"],

        [1, "rgb(240, 240, 255)"]

      ]

    },

    borderWidth: 2,

    plotBackgroundColor: "rgba(255, 255, 255, .9)",

    plotShadow: true,

    plotBorderWidth: 1

  )

  f.lang(thousandsSep: ",")

  f.colors(["#90ed7d", "#f7a35c", "#8085e9", "#f15c80", "#e4d354"])

end

```



### View Helpers:

```ruby

<%= high_chart_globals(@chart_globals) %>

<%= high_chart("some_id", @chart) %>

```



`high_chart_globals` is optional. Use it to set the global options of all charts that are currently displayed on the page. More info [here](http://api.highcharts.com/highcharts#global).



### No Data



When your series has no data and you want to display a message using Highcharts' noData feature ([Highcarts doc](http://api.highcharts.com/highcharts/noData)) you have to include the `no-data-to-display.js` file like so:



````

//= require highcharts/highcharts

//= require highcharts/highcharts-more

//= require highcharts/modules/no-data-to-display

````



You can then set the actual message that is displayed like so:



````

    @chart = LazyHighCharts::HighChart.new('graph') do |f|

      f.options[:lang] = { noData: "My beautiful noData message" }

      f.title(text: nil)

      f.series([])

    end

````



### Demo projects:



[Nanoc App](spec/dummy_nanoc)



[Rails App](spec/dummy_rails)



[Sinatra App](spec/dummy_sinatra)



### Update to latest js library. Additional command line



  To update to the current highcharts.js directly from http://code.highcharts.com/",  you can always run 



    rake highcharts:update



  And HC will be copied to your vendor/assets directory on your app



### Deprecation notice: 



If you use rails 2.3.x or 3.0.x or 3.1.x, please use versions less than 1.3.3.



## Contributing



We're open to any contribution. It has to be tested properly though.



* [Fork](http://help.github.com/forking/) the project

* Do your changes and commit them to your repository

* Test your changes. We won't accept any untested contributions (except if they're not testable).

* Create an [issue](https://github.com/michelson/lazy_high_charts/issues) with a link to your commits.



Thanks for all [contributors](https://github.com/michelson/lazy_high_charts/contributors)



## Maintainers

* Deshi Xiao [github/xiaods](https://github.com/xiaods)

* Miguel Michelson [github/michelson](https://github.com/michelson)



## License

* Copyright (c) 2008-2014 [MIT LICENSE](MIT-LICENSE)