React Charts - Export and Printing API

You can use two approaches to print and export the Chart: call methods, or add a built-in button with drop-down options. The supported export formats are PNG, PDF, JPEG, SVG, and GIF.

en.wikipedia.org

Was this demo helpful?

Thank you!

Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.

Thank you for the feedback!

TS JS

Backend API

import React, { useCallback, useRef } from 'react'; import Chart, { Series, Legend, Tooltip, ArgumentAxis, Label, ValueAxis, VisualRange, } from 'devextreme-react/chart'; import Button from 'devextreme-react/button'; import { mountains } from './data.ts'; function customizeTooltipText(pointInfo) { return { text: `<span class='title'>${pointInfo.argumentText}</span><br /> <br />System: ${pointInfo.point.data.system}<br />Height: ${pointInfo.valueText} m`, }; } function customizeLabelText({ value }) { return `${value} m`; } function App() { const chartRef = useRef(null); const printChart = useCallback(() => { chartRef.current.instance().print(); }, []); const exportChart = useCallback(() => { chartRef.current.instance().exportTo('Example', 'png'); }, []); return ( <React.Fragment> <Chart id="chart" ref={chartRef} dataSource={mountains} title="The Highest Mountains" > <Series argumentField="name" valueField="height" type="bar" color="#E55253" /> <ArgumentAxis visible={true} /> <ValueAxis> <VisualRange startValue={8000} /> <Label customizeText={customizeLabelText} /> </ValueAxis> <Tooltip enabled={true} customizeTooltip={customizeTooltipText} /> <Legend visible={false} /> </Chart> <div id="buttonGroup"> <Button icon="print" text="Print" onClick={printChart} />   <Button icon="export" text="Export" onClick={exportChart} /> </div> </React.Fragment> ); } export default App;

import React, { useCallback, useRef } from 'react'; import Chart, { Series, Legend, Tooltip, ArgumentAxis, Label, ValueAxis, VisualRange, } from 'devextreme-react/chart'; import Button from 'devextreme-react/button'; import { mountains } from './data.js'; function customizeTooltipText(pointInfo) { return { text: `<span class='title'>${pointInfo.argumentText}</span><br /> <br />System: ${pointInfo.point.data.system}<br />Height: ${pointInfo.valueText} m`, }; } function customizeLabelText({ value }) { return `${value} m`; } function App() { const chartRef = useRef(null); const printChart = useCallback(() => { chartRef.current.instance().print(); }, []); const exportChart = useCallback(() => { chartRef.current.instance().exportTo('Example', 'png'); }, []); return ( <React.Fragment> <Chart id="chart" ref={chartRef} dataSource={mountains} title="The Highest Mountains" > <Series argumentField="name" valueField="height" type="bar" color="#E55253" /> <ArgumentAxis visible={true} /> <ValueAxis> <VisualRange startValue={8000} /> <Label customizeText={customizeLabelText} /> </ValueAxis> <Tooltip enabled={true} customizeTooltip={customizeTooltipText} /> <Legend visible={false} /> </Chart> <div id="buttonGroup"> <Button icon="print" text="Print" onClick={printChart} />   <Button icon="export" text="Export" onClick={exportChart} /> </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'), );

export const mountains = [{ name: 'Everest', height: 8848, system: 'Mahalangur Himalaya', }, { name: 'Godwin Austen', height: 8611, system: 'Baltoro Karakoram', }, { name: 'Kangchenjunga', height: 8586, system: 'Kangchenjunga Himalaya', }, { name: 'Lhotse', height: 8516, system: 'Mahalangur Himalaya', }, { name: 'Makalu', height: 8485, system: 'Mahalangur Himalaya', }, { name: 'Cho Oyu', height: 8188, system: 'Mahalangur Himalaya', }];

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

export const mountains = [ { name: 'Everest', height: 8848, system: 'Mahalangur Himalaya', }, { name: 'Godwin Austen', height: 8611, system: 'Baltoro Karakoram', }, { name: 'Kangchenjunga', height: 8586, system: 'Kangchenjunga Himalaya', }, { name: 'Lhotse', height: 8516, system: 'Mahalangur Himalaya', }, { name: 'Makalu', height: 8485, system: 'Mahalangur Himalaya', }, { name: 'Cho Oyu', height: 8188, system: 'Mahalangur Himalaya', }, ];

<!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/24.1.7/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script> <script src="https://unpkg.com/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>

#chart { height: 440px; margin-bottom: 30px; } #buttonGroup { text-align: center; margin-bottom: 20px; } #buttonGroup > .dx-button { margin: 0 20px; } .title { font-size: 15px; font-weight: 500; }

Use Methods to Export and Print Chart

Use the exportTo(fileName, format) and print() methods to export and print the Chart. In this demo, two buttons below the chart implement the print and export functionality. A click on the "Print" button calls the Print dialog window, and a click on the "Export" button saves a file with the component to your local storage. You can specify the file name and format in the exportTo(fileName, format) method.

Export and Print Chart with a Built-in Menu

To automatically create a button with export and print options, use the export object and set its enabled property to true. If you want to disable printing, set the printingEnabled property to false.

Set the formats property to specify an array of available export formats. The fileName property allows you to specify the name of the exported file.

You can see how this approach works in the following demo: JSON Data.

Handle Export Events

Use the following events to handle export:

onExporting
Occurs before the Chart export.
onExported
Occurs after the Chart export.

NOTE

Need to create printable documents simply? Try our .NET-based DevExpress Reports: they ship with an intuitive Visual Studio Report Designer, Web Report Designer for end-user ad-hoc reporting, and a rich set of report controls, including cross tabs and charts.

You can generate a variety of report types — from simple mail-merge, table, and vertical reports to master-detail (hierarchical) and cross-tab reports, print or export them to PDF, Excel, and other formats.

Develop using VS Code? Leverage the capabilities of a brand new VS Code Report Designer extension to create and edit reports/documents on any platform, be it Windows, macOS, or Linux.

Get Started with DevExpress Reports | Explore Demos