Create a Chart in Ember Using FusionCharts
Overview
The ember-fusioncharts component, provide bindings for FusionCharts JavaScript charting library. It lets you add interactive JavaScript charts and graphs to your web and mobile applications using EmberJS component.
In this page, we'll see how to install FusionCharts and render a chart using the ember-fusionCharts
component.
Installation
To install FusionCharts and the ember-fusioncharts
component via npm
follow the steps below:
Step 1: Install fusioncharts
core library
$ npm install fusioncharts --save
Step 2: Install ember-fusioncharts
You can install ember-fusioncharts
component for any of the following CLI:
$ ember install ember-fusioncharts
That completes the installation of FusionCharts and the ember-fusioncharts
component.
Create your first chart
Let's create a Column 2D chart using the ember-fusioncharts
component showing the "Countries With Most Oil Reserves".
FusionCharts Suite has 95+ chart types for you to explore. Find the complete list of chart types here.
The Column 2D chart is shown below:
To understand the chart components, click here.
Chart data
The data to render the above chart is shown in the table below:
Country | No. of Oil Reserves |
---|---|
Venezuela | 290K |
Saudi | 260K |
Canada | 180K |
Iran | 140K |
Russia | 115K |
UAE | 100K |
US | 30K |
China | 30K |
FusionCharts accepts data in JSON format. Following code is the JSON representation of the above table with the required attributes to render the above chart.
{
// Chart Configuration
"chart": {
"caption": "Countries With Most Oil Reserves [2017-18]",
"subCaption": "In MMbbl = One Million barrels",
"xAxisName": "Country",
"yAxisName": "Reserves (MMbbl)",
"numberSuffix": "K",
"theme": "fusion"
},
// Chart Data
"data": [
{
"label": "Venezuela",
"value": "290"
},
{
"label": "Saudi",
"value": "260"
},
{
"label": "Canada",
"value": "180"
},
{
"label": "Iran",
"value": "140"
},
{
"label": "Russia",
"value": "115"
},
{
"label": "UAE",
"value": "100"
},
{
"label": "US",
"value": "30"
},
{
"label": "China",
"value": "30"
}
]
}
Different types of charts in FusionCharts expect different JSON formats, based on their grouping. Explore different JSON formats, for example, single-series,multi-series, combination charts.
In the above JSON data:
Create the
chart
object to define the elements of the chart.Set the
caption
andsubcaption
of the chart.Set the value of
xAxisName
attribute to Country(first column of the table).Set the value of
yAxisName
attribute to Reserves(second column of the table).In the
data
array, create objects for each row and specify thelabel
attribute to represent the Country. For example, Venezuela.Similarly, specify the
value
attribute to set the value of Oil Reserves in respective countries. For example, 290K for Venezuela.Set the
numberSuffix
attribute to set the unit of the values.Set the
theme
attribute to apply the predefines themes to the chart.
Both the chart object and the data array contain a set of key-value pairs known as attributes. These attributes are used to set the functional and cosmetic properties of the chart.
Now that you have the data in JSON format, let's see how to render the chart.
Render the chart
To render the chart using ember-fusioncharts
component, follow the steps below:
Step 1: In ember-cli-build.js
file include the necessary files and add the dependency.
Import FusionCharts library to your
ember-cli-build.js
fileImport
ember-fusioncharts
to yourember-cli-build.js
fileImport specific modules to your
ember-cli-build.js
fileImport the FusionCharts theme file to apply the style to the charts
Import the
ExcelExport
module to export chart data in XLSX format.
If you need to use different assets in different environments, specify an object as the first parameter. That object's keys should be the environment name and the values should be the asset to use in that environment.
/* eslint-env node */
"use strict";
const EmberApp = require("ember-cli/lib/broccoli/ember-app");
module.exports = function(defaults) {
let app = new EmberApp(defaults, {
// Add options here
});
// Import fusioncharts library
app.import("node_modules/fusioncharts/fusioncharts.js");
app.import("node_modules/fusioncharts/fusioncharts.charts.js");
app.import("node_modules/fusioncharts/themes/fusioncharts.theme.fusion.js");
app.import("node_modules/fusioncharts/features/excelexport");
// Use `app.import` to import additional libraries/files
return app.toTree();
};
To include specific chart types, individually add the following files using import
:
- PowerCharts -
fusioncharts/fusioncharts.powercharts
- Widgets -
fusioncharts/fusioncharts.widgets
- Gantt -
fusioncharts/fusioncharts.gantt
- Treemap -
fusioncharts/fusioncharts.treemap
- Zoomscatter -
fusioncharts/fusioncharts.zoomscatter
- Zoomline -
fusioncharts/fusioncharts.zoomline
- Overlapped Bar -
fusioncharts/fusioncharts.overlappedbar2d
- Overlapped Column -
fusioncharts/fusioncharts.overlappedcolumn2d
Step 2: Create Component and specify the chart data in chart-viewer.js
file
Create a simple component (e.g. chart-viewer) to render your chart.
Add data to
chart-viewer.js
fileSet the chart
width
andheight
Set the chart type as
column2d
. Each chart type is represented with a unique chart alias. For Column 2D chart, the alias iscolumn2d
. Find the complete list of chart types with their respective alias here.Set the data source
$ ember g component chart-viewer
import Component from "@ember/component";
const myDataSource = {
chart: {
caption: "Countries With Most Oil Reserves [2017-18]",
subCaption: "In MMbbl = One Million barrels",
xAxisName: "Country",
yAxisName: "Reserves (MMbbl)",
numberSuffix: "K",
theme: "fusion"
},
// Chart Data
data: [
{
label: "Venezuela",
value: "290"
},
{
label: "Saudi",
value: "260"
},
{
label: "Canada",
value: "180"
},
{
label: "Iran",
value: "140"
},
{
label: "Russia",
value: "115"
},
{
label: "UAE",
value: "100"
},
{
label: "US",
value: "30"
},
{
label: "China",
value: "30"
}
]
}; // end of this.dataSource
export default Component.extend({
title: "Ember FusionCharts Sample",
width: 700,
height: 400,
type: "column2d",
dataFormat: "json",
dataSource: myDataSource
});
Step 3: Add data to chart-viewer.hbs
Add fusioncharts
component to your chart-viewer.hbs
template to render the chart:
<h1>{{ title }}</h1>
{{fusioncharts-xt width=width height=height type=type dataFormat=dataFormat
dataSource=dataSource }}
Step 4: Add data to application.hbs
Add chart-viewer
component to your application.hbs
template:
{{chart-viewer}} {{outlet}}
That's it! Your first chart using ember-fusioncharts
is ready.
Problem rendering the chart?
In case there is an error, and you are unable to see the chart, check for the following:
If you are getting a JavaScript error on your page, check your browser console for the exact error and fix accordingly. If you're unable to solve it, click here to get in touch with our support team.
If the chart does not show up at all, but there are no JavaScript errors, check if the FusionCharts Suite XT JavaScript library has loaded correctly. You can use developer tools within your browser to see if
fusioncharts.js
was loaded.If you get a Loading Data or Error in loading data message, check whether your JSON data structure is correct, or there are conflicts related to quotation marks in your code.