ember-highcharts

Ember-highcharts

A Highcharts component for Ember CLI.

Installation

1. Install the addon:

    ember install:addon ember-highcharts
    
   

2. Depending on whether you want to use Highcharts, Highstock or Highmaps, install corresponding Bower package.

Do one of the following commands:

    bower install --save highcharts-release
    bower install --save highstock-release
    bower install --save highmaps-release
    

3. In your Brocfile.js, tell Broccoli to import the package you have just installed.

Add one of the following lines:

    app.import('bower_components/highcharts-release/highcharts.src.js');
    app.import('bower_components/highstock-release/highstock.src.js');
    app.import('bower_components/highmaps-release/highmaps.src.js');
    

Depending on what Highcharts features you're gonna use, you might need to import additional files. Refer to Highcharts documentation.

Usage

In your template:

{{high-charts mode=chartMode content=chartData chartOptions=chartOptions}}

Then in a controller you can set the chartMode, chartData and chartOptions values:

import Ember from 'ember';

export default Ember.Controller.extend({
  chartMode: 'StockChart', // Available options: a falsy value, 'StockChart', 'Map'.
                           // If `mode` is not provided or is a falsy value, the chart is initialized in Charts mode.
                           // If `mode` is a string, it is passed to Highcharts as the first argument.
                           // When Highcharts introduces a new mode, you will be able to use it here right away.

  chartOptions: {
    chart: {
        type: 'bar'
    },
    title: {
      text: 'Fruit Consumption'
    },
    xAxis: {
      categories: ['Apples', 'Bananas', 'Oranges']
    },
    yAxis: {
      title: {
          text: 'Fruit eaten'
      }
    }
  },
  
  chartData: [
    {
      name: 'Jane',
      data: [1, 0, 4]
    }, {
      name: 'John',
      data: [5, 7, 3]
    }
  ]
});

Configuring Default Styles

Ember-highcharts provides its own set of default configurations in addon/utils/option-loader.js. At runtime you can optionally configure custom styles by providing a app/highcharts-configs/application.js file. This file should provide a hook that returns the final configuration.

 // app/highcharts-configs/application.js

 export default function(defaultOptions) {
   defaultOptions.credits.href = 'http://www.my-great-chart.com';
   defaultOptions.credits.text = 'great charts made cheap';
   defaultOptions.credits.enabled = true;

   return defaultOptions;
 }

Credit

This add-on is built based on the gist and medium by @poteto

Changelog

0.0.5

• Added an ability to use Highstock and Highmaps.
• The addon no longer automatically imports the Highcharts Bower package, letting user import desired package manually.

0.0.6

• Updated tests.
• Added Highstock demo to the dummy app.