JavaScript Data GridExcel Export - Page Setup

Enterprise

Excel Export allows you to configure the page settings for the exported Excel file.

Page Setup

You can customise the Excel export page settings such as page size, orientation, and margin, using the pageSetup and margins configs of the Excel Export Params. These settings are visible when printing the exported Excel file or exporting to PDF.

const gridOptions = {
    defaultExcelExportParams: {
        pageSetup: {
            orientation: 'Landscape',
            pageSize: 'A3'
        },
        margins: {
            top: 1,
            right: 1,
            bottom: 1,
            left: 1,
            header: 0.5,
            footer: 0.5,
        }
    },

    // other grid options ...
}

The value of the margins must be provided in inches.

Note the following:

  • The sample below allow you to configure the page size, orientation and margin values.
  • Page size and orientation are stored in the pageSetup object.
  • Margin values are stored in the margins object.

Interfaces

ExcelExportParams

interface ExcelExportParams {
    // ...
    margins?: ExcelSheetMargin;
    pageSetup?: ExcelSheetPageSetup
}

ExcelSheetMargin

Properties available on the ExcelSheetMargin interface.

top
number
default: 0.75
The sheet top margin.
right
number
default: 0.7
The sheet right margin.
bottom
number
default: 0.75
The sheet bottom margin.
left
number
default: 0.7
The sheet left margin.
header
number
default: 0.3
The sheet header margin.
number
default: 0.3
The sheet footer margin.

ExcelSheetPageSetup

Properties available on the ExcelSheetPageSetup interface.

orientation
'Portrait' | 'Landscape'
default: 'Portrait'
Use this property to change the print orientation.
pageSize
| 'Letter' | 'Letter Small' | 'Tabloid' | 'Ledger' | 'Legal' | 'Statement' | 'Executive' | 'A3' | 'A4' | 'A4 Small' | 'A5' | 'A6' | 'B4' | 'B5' | 'Folio' | 'Envelope' | 'Envelope DL' | 'Envelope C5' | 'Envelope B5' | 'Envelope C3' | 'Envelope C4' | 'Envelope C6' | 'Envelope Monarch' | 'Japanese Postcard' | 'Japanese Double Postcard'
default: 'Letter'
Use this property to set the sheet size.