Create a Chart in Vue
FusionTime is a JavaScript charting library that helps you visualize, and explore time-series data. In FusionTime, you get lots of out-of-the-box interactive features, such as time navigator, date range selectors, tooltips with crosslines, interactive legend and more. These features enhance the experience of exploring and understanding time-series data.
We have built a simple vue-fusioncharts
component, which provides bindings for FusionTime. The vue-fusioncharts
directive allows you to easily add interactive time-series charts to any Vue project.
In this page, we'll see how to install FusionTime and render an interactive time-series chart using the vue-fusioncharts
directive.
Installation
Since FusionTime is distributed along with FusionCharts Suite, download/install the FusionCharts package to get access to FusionTime and other chart types of the FusionCharts Suite. To install follow the steps below:
vue-fusioncharts
component via npm follow the steps below:vue-fusioncharts
component
$ npm install vue-fusioncharts --save
fusioncharts
package
$ npm install fusioncharts --save
vue-fusioncharts
component follow the steps below:vue-fusioncharts
component.
<head>
<!-- Step 1 - Including vue -->
<script type="text/javascript" src="https://unpkg.com/[email protected]"></script>
<!-- Step 2 - Including vue-fusioncharts component -->
<script type="text/javascript" src="https://unpkg.com/vue-fusioncharts/dist/vue-fusioncharts.min.js"></script>
<!-- Step 3 - Including the fusioncharts core library -->
<script type="text/javascript" src="https://cdn.fusioncharts.com/fusioncharts/latest/fusioncharts.js"></script>
<!-- Step 4 - Including the FusionTime File -->
<script type="text/javascript" src="https://cdn.fusioncharts.com/fusioncharts/latest/fusioncharts.timeseries.js"></script>
</head>
vue-fusioncharts
component follow the steps below:vue-fusioncharts
component.
<head>
<!-- Step 1 - Including vue -->
<script type="text/javascript" src="path/to/local/vue.js"></script>
<!-- Step 2 - Including vue-fusioncharts component -->
<script type="text/javascript" src="path/to/local/vue-fusioncharts.js"></script>
<!-- Step 3 - Including the fusioncharts core library -->
<script type="text/javascript" src="path/to/local/fusioncharts.js"></script>
<!-- Step 4 - Including the FusionTime File -->
<script type="text/javascript" src="path/to/local/fusioncharts.timeseries.js"></script>
</head>
Usage
The two methods to add vue-fusioncharts
component to your project are:
- Register globally as a plugin
- Register locally in your component
Registering globally as a plugin
- Import vue,
vue-fusioncharts
, and FusionCharts in main app file.
import Vue from `vue`;
import VueFusionCharts from 'vue-fusioncharts';
// import FusionCharts modules and resolve dependency
import FusionCharts from 'fusioncharts';
import TimeSeries from 'fusioncharts/fusioncharts.timeseries;
- Register it as a plugin in your Vue object
Vue.use(VueFusionCharts, FusionCharts, TimeSeries);
The above method to add the component to your project is recommended only if you want to avail the
vue-fusioncharts
component from anywhere in the application.
Registering locally in your component
- Import the chart component from
vue-fusioncharts
component package to your component file and use Vue.component to register it locally.
import Vue from `vue`;
import VueFusionChartsComponent from 'vue-fusioncharts/component';
// import FusionCharts modules and resolve dependency
import FusionCharts from 'fusioncharts';
import TimeSeries from 'fusioncharts/fusioncharts.timeseries;
const vueFusionCharts = VueFusionChartsComponent(FusionCharts, TimeSeries);
Vue.component('fusioncharts', vueFusionCharts);
The above method to add the component in your project is recommended when you want to restrict the availability of
vue-fusioncharts
component to a specific file or folder.
Create Your First Chart
Let's create a timeseries charts using vue-fusioncharts
component showing Daily sales of a grocery store.
The chart will look as shown below:
The data for the above chart is too big to be displayed here. The table below shows the sample data of the above chart:
Time | Sales |
---|---|
01-Feb-11 | 8866 |
02-Feb-11 | 2174 |
03-Feb-11 | 2084 |
04-Feb-11 | 1503 |
05-Feb-11 | 4928 |
06-Feb-11 | 4667 |
07-Feb-11 | 1064 |
FusionTime accepts a DataTable as the data source. DataTable
is the tabular representation of data. To create the DataTable
, you need to provide the following:
schema
- which defines the properties of the columns.data
- which contains the values of each row and column of the DataTable.
For an instance of FusionTime, you can create
n
number ofDataTables
, but only oneDataStore
.
Now, let's learn how to prepare the schema and the data of the DataTable
.
Create the schema
The schema outlines each column represented in the above table. The schema contains an array which has multiple objects created in it. Each object represents a column of the above table.
name
andtype
are mandatory keys for each object. If the object type istime
thenformat
is also a mandatory key.
To define the schema, let's create a schema.json
file and copy the following code:
It is not mandatory to create the schema in a different
.json
file. You can also define the schema within the.html
file.
Let schema = [{
"name": "Time",
"type": "date",
"format": "%-m/%-d/%Y"
}, {
"name": "Sales",
"type": "number"
}]
In the above code:
schema
is the variable in which the array is stored.- Each object of a schema maps to a column of the tabular representation of the data.
- The JSON object has the following attributes:
- name - Specify the name of the column of the tabular representation of data
- type - Specify the type of the column.
- format - Specify the input format of the date as per your data. In this example, the format is
%-m/%-d/%Y
. To know more on date formats click here.
Now that we have the schema ready, let's work on the data.
Create data
Data can be provided either in JSON format or 2D array format. We will use the 2D array format.
Data for the above chart is too big to be shown here. A sample of it has been used in the data object defined below:
var data = [
[
"1/4/2011",
16.448
],
[
"1/5/2011",
272.736
],
[
"1/5/2011",
11.784
],
[
"1/5/2011",
3.54
],
[
"1/6/2011",
19.536
],
[
"1/7/2011",
2573.82
],
]
Create a new data.json
file, and copy the above code there. Next, copy the entire data and replace it with the content of the data object in your 'data.json' file.
It is not mandatory to create a
data.json
file. You can also do the same in your HTML file.
In the above code:
data
is the variable in which the data array is stored.- Each object in the data array corresponds to a row in the tabular representation of the data.
- Each element in an object is represented by each object of the
schema
. The values in each object of the array represent the following:- Time according to the format
- Total sales amount
We are all set with our data to create the chart.
By default, FusionTime applies the average function to aggregate the data and display on the chart. You can change the aggregate function from
average
to any other numeric calculation. To know more, click here.
Now, let's create the files to render the above chart.
Render the chart
To render the chart, create a .js
file and copy the following code:
import Vue from 'vue';
import VueFusionCharts from 'vue-fusioncharts';
import FusionCharts from 'fusioncharts';
import TimeSeries from 'fusioncharts/fusioncharts.timeseries';
// register VueFusionCharts
Vue.use(VueFusionCharts, FusionCharts, TimeSeries);
const jsonify = res => res.json();
const dataFetch = fetch(
'https://s3.eu-central-1.amazonaws.com/fusion.store/ft/data/line-chart-with-time-axis-data.json'
).then(jsonify);
const schemaFetch = fetch(
'https://s3.eu-central-1.amazonaws.com/fusion.store/ft/schema/line-chart-with-time-axis-schema.json'
).then(jsonify);
const chart = new Vue({
el: '#app',
data: {
width: '700',
height: '400',
type: 'timeseries',
dataFormat: 'json',
dataSource: {
data: null,
caption: {
text: 'Sales Analysis'
},
subcaption: {
text: 'Grocery'
},
yAxis: [{
plot: {
value: 'Grocery Sales Value',
type: 'line'
},
format: {
prefix: '$'
},
title: 'Sale Value'
}]
}
},
mounted: function() {
// In this Promise we will create our DataStore and using that we will create a custom DataTable which takes two
// parameters, one is data another is schema.
Promise.all([dataFetch, schemaFetch]).then(res => {
const data = res[0];
const schema = res[1];
// First we are creating a DataStore
const fusionDataStore = new FusionCharts.DataStore();
// After that we are creating a DataTable by passing our data and schema as arguments
const fusionTable = fusionDataStore.createDataTable(data, schema);
// After that we simply mutated our timeseries datasource by attaching the above
// DataTable into its data property.
this.dataSource.data = fusionTable;
});
}
});
<html lang="en">
<head>
</head>
<body>
<script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script>
<script src="https://unpkg.com/[email protected]/fusioncharts.js"></script>
<script src="https://unpkg.com/[email protected]/fusioncharts.timeseries.js"></script>
<!-- If you want to use vue-fusioncharts as a plugin -->
<script src="https://unpkg.com/[email protected]/dist/vue-fusioncharts.js"></script>
<!-- If you want to use vue-fusioncharts as a component -->
<!-- <script src="https://unpkg.com/[email protected]/component/index.js"></script> -->
<script>
// Register vue-fusioncharts as a plugin if you want to use it globally
Vue.use(VueFusionCharts, FusionCharts);
// Links to fetch data and schema for TimeSeries chart
const jsonify = res => res.json();
var dataFetch = fetch(
'https://s3.eu-central-1.amazonaws.com/fusion.store/ft/data/line-chart-with-time-axis-data.json'
).then(jsonify);
var schemaFetch = fetch(
'https://s3.eu-central-1.amazonaws.com/fusion.store/ft/schema/line-chart-with-time-axis-schema.json'
).then(jsonify);
// Create vue-fusioncharts component
// let vFC = VueFusionChartsComponent(FusionCharts);
var app = new Vue({
el: '#app',
// Register the vue-fusioncharts component you created earlier if you want to use it locally
// components: { fusioncharts: vFC },
data: {
width: '700',
height: '400',
type: 'timeseries',
dataFormat: 'json',
displayChart: false,
dataSource: {
// Initially data is set as null
data: null,
caption: {
text: 'Sales Analysis'
},
subcaption: {
text: 'Grocery'
},
yAxis: [
{
plot: {
value: 'Grocery Sales Value',
type: 'line'
},
format: {
prefix: '$'
},
title: 'Sale Value'
}
]
}
},
mounted: function() {
// In this Promise we will create our DataStore and using that we will create a custom DataTable which takes two
// parameters, one is data another is schema.
Promise.all([dataFetch, schemaFetch]).then(res => {
const data = res[0];
const schema = res[1];
// First we are creating a DataStore
const fusionDataStore = new FusionCharts.DataStore();
// After that we are creating a DataTable by passing our data and schema as arguments
const fusionTable = fusionDataStore.createDataTable(data, schema);
// After that we simply mutated our timeseries datasource by attaching the above
// DataTable into its data property.
this.dataSource.data = fusionTable;
});
}
});
</script>
</body>
</html>
<html lang="en">
<head>
</head>
<body>
<script type="text/javascript" src="path/to/local/vue.js"></script>
<script type="text/javascript" src="path/to/local/fusioncharts.js"></script>
<script type="text/javascript" src="path/to/local/fusioncharts.timeseries.js"></script>
<!-- If you want to use vue-fusioncharts as a plugin -->
<script type="text/javascript" src="path/to/local/vue-fusioncharts.js"></script>
<!-- If you want to use vue-fusioncharts as a component -->
<!-- <script src="https://unpkg.com/[email protected]/component/index.js"></script> -->
<script>
// Register vue-fusioncharts as a plugin if you want to use it globally
Vue.use(VueFusionCharts, FusionCharts);
// Links to fetch data and schema for TimeSeries chart
const jsonify = res => res.json();
var dataFetch = fetch(
'https://s3.eu-central-1.amazonaws.com/fusion.store/ft/data/line-chart-with-time-axis-data.json'
).then(jsonify);
var schemaFetch = fetch(
'https://s3.eu-central-1.amazonaws.com/fusion.store/ft/schema/line-chart-with-time-axis-schema.json'
).then(jsonify);
// Create vue-fusioncharts component
// let vFC = VueFusionChartsComponent(FusionCharts);
var app = new Vue({
el: '#app',
// Register the vue-fusioncharts component you created earlier if you want to use it locally
// components: { fusioncharts: vFC },
data: {
width: '700',
height: '400',
type: 'timeseries',
dataFormat: 'json',
displayChart: false,
dataSource: {
// Initially data is set as null
data: null,
caption: {
text: 'Sales Analysis'
},
subcaption: {
text: 'Grocery'
},
yAxis: [
{
plot: {
value: 'Grocery Sales Value',
type: 'line'
},
format: {
prefix: '$'
},
title: 'Sale Value'
}
]
}
},
mounted: function() {
// In this Promise we will create our DataStore and using that we will create a custom DataTable which takes two
// parameters, one is data another is schema.
Promise.all([dataFetch, schemaFetch]).then(res => {
const data = res[0];
const schema = res[1];
// First we are creating a DataStore
const fusionDataStore = new FusionCharts.DataStore();
// After that we are creating a DataTable by passing our data and schema as arguments
const fusionTable = fusionDataStore.createDataTable(data, schema);
// After that we simply mutated our timeseries datasource by attaching the above
// DataTable into its data property.
this.dataSource.data = fusionTable;
});
}
});
</script>
</body>
</html>
In the above code:
Include Vue and
vue-fusioncharts
component.Include the fusioncharts library.
Include the TimeSeries as chart type.
Include
data.json
andschema.json
files.Define the chart configuration in the FusionCharts constructor:
Set the type as
timeseries
.Set the chart container as
container
using therenderAt
property.Set the width and height (in pixels).
Set the name of the
DataTable
as the value of thedata
property ofdataSource
.Set the data to create the chart.
Specify the caption of the chart using
text
attribute in thecaption
object.
Create an empty storage as
fusionDataStore
usingFusionCharts.DataStore
.Create a
DataTable
within the empty storage usingfusionDataStore.createDataTable
and pass theschema
anddata
to theDataTable
.
The HTML template of the above example is:
<div id="app">
<fusioncharts
:width="width"
:height="height"
:type="type"
:dataFormat="dataFormat"
:dataSource="dataSource"
>
FusionCharts will render here...
</fusioncharts>
</div>