React Common - Utils - pdfExporter
exportDataGrid(options) CTP
A Promise that is resolved when the grid data is prepared for export. It is a native Promise or a jQuery.Promise when you use jQuery.
This method requires the jsPDF library to export data and the jsPDF-AutoTable plugin to create tables in exported files.
You can call this method at any point in your application. In this example, we call this method in a standalone button's onClick handler:
- npm install jspdf jspdf-autotable
- import React from 'react';
- import 'devextreme/dist/css/dx.light.css';
- import DataGrid from 'devextreme-react/data-grid';
- import Button from 'devextreme-react/button';
- import { jsPDF } from 'jspdf';
- import 'jspdf-autotable';
- import { exportDataGrid as exportDataGridToPdf } from 'devextreme/pdf_exporter';
- export default function App() {
- const dataGridRef = useRef(null);
- function exportGrid() {
- const doc = new jsPDF();
- const dataGrid = dataGridRef.current.instance;
- exportDataGridToPdf({
- jsPDFDocument: doc,
- component: dataGrid
- }).then(() => {
- doc.save('Customers.pdf');
- });
- }
- return (
- <React.Fragment>
- <div>
- <Button ...
- onClick={exportGrid}
- />
- <DataGrid ...
- ref={dataGridRef}
- >
- {/* ... */}
- </DataGrid>
- </div>
- </React.Fragment>
- );
- }
exportGantt(options)
A Promise that is resolved after the Gantt data is exported. It is a native Promise or a jQuery.Promise when you use jQuery.
This method requires the jsPDF library to export data and the jsPDF-AutoTable plugin to create tables in exported files.
The exportGantt(options) method allows you to save information about the Gantt chart's layout, appearance, and tasks. This method supports the following options:
- createDocumentMethod - Specifies a function that creates a PDF document.
- format {string | width?: number, height?: number } - Specifies the document size.
- landscape {boolean} - Specifies whether to use horizontal orientation for the document.
- fileName {string} - Specifies the file name.
- exportMode {"all", "treeList", "chart"} - Specifies the part of the component to export (chart area, tree list area, or the entire component).
- dateRange {"all" | "visible" | startDate? : Date, endDate? : Date, startIndex? : number, endIndex? : number } - Restricts data output against a specified date range.
- margins { left?: number, top?: number, right?: number, bottom?: number } - Specifies the outer indents of the exported area.
The exporter supports standard PDF fonts. Refer to the Use of Unicode Characters / UTF-8 article to get information on how to use custom fonts for exporting.
You can call the exportGantt method at any point in your application. In the example below, this method is called in a standalone toolbar item's onClick event handler:
- import React from 'react';
- import 'devextreme/dist/css/dx.light.css';
- import 'devexpress-gantt/dist/dx-gantt.css';
- import Gantt, {
- Toolbar, Item,
- } from 'devextreme-react/gantt';
- import { exportGantt as exportGanttToPdf } from 'devextreme/pdf_exporter';
- import { jsPDF } from 'jspdf';
- import 'jspdf-autotable';
- const App = () => {
- const ganttRef = React.createRef();
- const exportButtonOptions = {
- icon: 'exportpdf',
- hint: 'Export to PDF',
- stylingMode: 'text',
- onClick: 'exportButtonClick',
- };
- const exportButtonClick = (e) => {
- const gantt = ganttRef.current.instance;
- exportGanttToPdf(
- {
- component: gantt,
- createDocumentMethod: (args) => new jsPDF(args),
- format: 'a4',
- exportMode: 'all',
- dateRange: 'visible',
- },
- ).then((doc) => doc.save('gantt.pdf'));
- }
- return (
- <Gantt ... >
- <Toolbar>
- {/* ... */}
- <Item
- widget="dxButton"
- options={this.exportButtonOptions}
- />
- </Toolbar>
- {/* ... */}
- </Gantt>
- );
- };
- export default App;
The following code snippet illustrates how to process the PDF document when the export is complete:
- var gantt = $("#ganttContainer").dxGantt("instance");
- gantt.exportToPdf({
- format: "A4",
- landscape: true,
- exportMode: "chart",
- dateRange: "visible"
- }).then(function(doc) {
- doc.addPage();
- // your code
- doc.save('customDoc.pdf');
- });
To print the exported PDF document, call the autoPrint method:
- var gantt = $("#ganttContainer").dxGantt("instance");
- gantt.exportToPdf({
- format: "A4",
- landscape: true,
- exportMode: "chart",
- dateRange: "visible"
- }).then(function(doc) {
- doc.autoPrint();
- window.open(doc.output('your_url'), '_blank');
- });
If you have technical questions, please create a support ticket in the DevExpress Support Center.