React Charts - Line

Line charts help visualize data and display them as lines with points placed over specified intervals. This demo shows how to initialize and configure Line, Stacked Line, and Full-Stacked Line charts. A Stacked Line chart visualizes multiple data series and allows you to compare the manner in which each series contributes to the total aggregate value for specific arguments. A Full-Stacked Line chart helps compare the percentage value of multiple line series for each argument. Use the drop-down menu under the chart to switch between chart types.

TS JS

Backend API

import React, { useCallback, useState } from 'react'; import SelectBox, { type SelectBoxTypes } from 'devextreme-react/select-box'; import { Chart, Series, ArgumentAxis, CommonSeriesSettings, Export, Legend, Margin, Title, Subtitle, Tooltip, Grid, } from 'devextreme-react/chart'; import { Properties as ChartPropsType } from 'devextreme/viz/chart'; import service from './data.ts'; const countriesInfo = service.getCountriesInfo(); const energySources = service.getEnergySources(); const types: (ChartPropsType['commonSeriesSettings']['type'])[] = ['line', 'stackedline', 'fullstackedline']; const seriesTypeLabel = { 'aria-label': 'Series Type' }; function App() { const [type, setType] = useState(types[0]); const handleChange = useCallback((e: SelectBoxTypes.ValueChangedEvent) => { setType(e.value); }, []); return ( <React.Fragment> <Chart palette="Violet" dataSource={countriesInfo}> <CommonSeriesSettings argumentField="country" type={type} /> {energySources.map((item) => ( <Series key={item.value} valueField={item.value} name={item.name} /> ))} <Margin bottom={20} /> <ArgumentAxis valueMarginsEnabled={false} discreteAxisDivisionMode="crossLabels"> <Grid visible={true} /> </ArgumentAxis> <Legend verticalAlignment="bottom" horizontalAlignment="center" itemTextPosition="bottom" /> <Export enabled={true} /> <Title text="Energy Consumption in 2004"> <Subtitle text="(Millions of Tons, Oil Equivalent)" /> </Title> <Tooltip enabled={true} /> </Chart> <div className="options"> <div className="caption">Options</div> <div className="option"> <span>Series Type </span> <SelectBox dataSource={types} inputAttr={seriesTypeLabel} value={type} onValueChanged={handleChange} /> </div> </div> </React.Fragment> ); } export default App;

import React, { useCallback, useState } from 'react'; import SelectBox from 'devextreme-react/select-box'; import { Chart, Series, ArgumentAxis, CommonSeriesSettings, Export, Legend, Margin, Title, Subtitle, Tooltip, Grid, } from 'devextreme-react/chart'; import service from './data.js'; const countriesInfo = service.getCountriesInfo(); const energySources = service.getEnergySources(); const types = ['line', 'stackedline', 'fullstackedline']; const seriesTypeLabel = { 'aria-label': 'Series Type' }; function App() { const [type, setType] = useState(types[0]); const handleChange = useCallback((e) => { setType(e.value); }, []); return ( <React.Fragment> <Chart palette="Violet" dataSource={countriesInfo} > <CommonSeriesSettings argumentField="country" type={type} /> {energySources.map((item) => ( <Series key={item.value} valueField={item.value} name={item.name} /> ))} <Margin bottom={20} /> <ArgumentAxis valueMarginsEnabled={false} discreteAxisDivisionMode="crossLabels" > <Grid visible={true} /> </ArgumentAxis> <Legend verticalAlignment="bottom" horizontalAlignment="center" itemTextPosition="bottom" /> <Export enabled={true} /> <Title text="Energy Consumption in 2004"> <Subtitle text="(Millions of Tons, Oil Equivalent)" /> </Title> <Tooltip enabled={true} /> </Chart> <div className="options"> <div className="caption">Options</div> <div className="option"> <span>Series Type </span> <SelectBox dataSource={types} inputAttr={seriesTypeLabel} value={type} onValueChanged={handleChange} /> </div> </div> </React.Fragment> ); } export default App;

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));

<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/25.1.6/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://cdn.jsdelivr.net/npm/core-js@2.6.12/client/shim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/systemjs@0.21.3/dist/system.js"></script> <script type="text/javascript" src="config.js"></script> <script type="text/javascript"> System.import("./index.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>

.options { padding: 20px; background-color: rgba(191, 191, 191, 0.15); margin-top: 20px; } .option { margin-top: 10px; } .caption { font-size: 18px; font-weight: 500; } .option > span { margin-right: 10px; } .option > .dx-widget { display: inline-block; vertical-align: middle; }

Bind to Data

You can bind line charts to one of the following data sources:

In this demo, the chart is populated with data from a local JavaScript array.

Configure Series

The series type defines the appearance of your chart. To display a Line, Stacked Line, or Full-Stacked Line series, set the type property to one of these types.

You also need to bind the series to data. Set the argumentField and valueField properties to data fields that contain arguments and values for your series. You can specify these properties in an object in the series array or include them in the commonSeriesSettings object. In this demo, the argumentField and type properties are specified for all series in the commonSeriesSettings object.

Enable Tooltips

When you hover the mouse pointer over a series point, it shows a tooltip with information about the series point. To display tooltips, you need to enable the tooltip.enabled property.

Export Chart to Image

To allow a user to print the chart or export it as a PNG, JPEG, or SVG file, set the export.enabled property to true. This setting adds a button that opens a drop-down menu with export and print commands. In this demo, you can find this button in the upper-right corner.