@mui/x-data-grid
Version:
The community edition of the data grid component (MUI X).
70 lines (69 loc) • 2.7 kB
JavaScript
import * as React from 'react';
import { useGridApiMethod } from '../../utils/useGridApiMethod';
import { useGridLogger } from '../../utils/useGridLogger';
import { exportAs } from '../../../utils/exportAs';
import { buildCSV } from './serializers/csvSerializer';
import { getColumnsToExport, defaultGetRowsToExport } from './utils';
import { useGridRegisterPipeProcessor } from '../../core/pipeProcessing';
import { GridCsvExportMenuItem } from '../../../components/toolbar/GridToolbarExport';
import { jsx as _jsx } from "react/jsx-runtime";
/**
* @requires useGridColumns (state)
* @requires useGridFilter (state)
* @requires useGridSorting (state)
* @requires useGridSelection (state)
* @requires useGridParamsApi (method)
*/
export const useGridCsvExport = (apiRef, props) => {
const logger = useGridLogger(apiRef, 'useGridCsvExport');
const ignoreValueFormatterProp = props.unstable_ignoreValueFormatterDuringExport;
const ignoreValueFormatter = (typeof ignoreValueFormatterProp === 'object' ? ignoreValueFormatterProp?.csvExport : ignoreValueFormatterProp) || false;
const getDataAsCsv = React.useCallback((options = {}) => {
logger.debug(`Get data as CSV`);
const exportedColumns = getColumnsToExport({
apiRef,
options
});
const getRowsToExport = options.getRowsToExport ?? defaultGetRowsToExport;
const exportedRowIds = getRowsToExport({
apiRef
});
return buildCSV({
columns: exportedColumns,
rowIds: exportedRowIds,
delimiterCharacter: options.delimiter || ',',
includeHeaders: options.includeHeaders ?? true,
includeColumnGroupsHeaders: options.includeColumnGroupsHeaders ?? true,
ignoreValueFormatter,
apiRef
});
}, [logger, apiRef, ignoreValueFormatter]);
const exportDataAsCsv = React.useCallback(options => {
logger.debug(`Export data as CSV`);
const csv = getDataAsCsv(options);
const blob = new Blob([options?.utf8WithBom ? new Uint8Array([0xef, 0xbb, 0xbf]) : '', csv], {
type: 'text/csv'
});
exportAs(blob, 'csv', options?.fileName);
}, [logger, getDataAsCsv]);
const csvExportApi = {
getDataAsCsv,
exportDataAsCsv
};
useGridApiMethod(apiRef, csvExportApi, 'public');
/**
* PRE-PROCESSING
*/
const addExportMenuButtons = React.useCallback((initialValue, options) => {
if (options.csvOptions?.disableToolbarButton) {
return initialValue;
}
return [...initialValue, {
component: /*#__PURE__*/_jsx(GridCsvExportMenuItem, {
options: options.csvOptions
}),
componentName: 'csvExport'
}];
}, []);
useGridRegisterPipeProcessor(apiRef, 'exportMenu', addExportMenuButtons);
};