Highcharts Dashboards with React
To create a dashboard with React, please follow the steps below:
1. Install the Dashboards package
npm install @highcharts/dashboards
2. Import the Dashboards package
import Dashboards from '@highcharts/dashboards';
3. Additional packages
Consider additional packages like Highcharts or Grid to fully utilize the Dashboards potential.
First, install the package.
npm install highcharts
Then, import the package and the dedicated plug to connect it to the Dashboards.
import Highcharts from 'highcharts/es-modules/masters/highcharts.src.js';
import Dashboards from '@highcharts/dashboards/es-modules/masters/dashboards.src.js';
import Grid from '@highcharts/dashboards/es-modules/masters/datagrid.src.js';
Dashboards.HighchartsPlugin.custom.connectHighcharts(Highcharts);
Dashboards.GridPlugin.custom.connectGrid(Grid);
Dashboards.PluginHandler.addPlugin(Dashboards.HighchartsPlugin);
Dashboards.PluginHandler.addPlugin(Dashboards.GridPlugin);
4. Create an HTML structure for the dashboard
There are two ways to do it:
Use the Dashboards layout system
To do that, first import the layout
module and initialize it:
import '@highcharts/dashboards/es-modules/masters/modules/layout.src.js';
Then add a div where you want to render the dashboard:
<div id="dashboard"></div>
You can refer to the element by its ID or use the ElementRef
to get it.
Declare your HTML structure
Read more in the documentation .
5. Create a dashboard
The dashboard is created using the factory function Dashboards.board
. The function takes three arguments:
container
- the element where the dashboard will be rendered, can be an id of the element or the direct reference to the elementoptions
- the options object for the dashboardisAsync
- whether the dashboard should be rendered asynchronously or not- functional when using external data resources
Demos
See how it works in the following demos: