-
-
Notifications
You must be signed in to change notification settings - Fork 119
Export to File
You can Export to File in multiple formats, the following format are currently supported
- Export to CSV format
- Export to Text file with a delimiter of your choice (Tab delimited is a good one to use)
The Grid Menu already has the "Export to CSV" enabled by default, so you will see it automatically in your Grid Menu. You still have the options to show or hide the 2 types of export
-
showExportCsvCommand
true by default, so it's optional -
showExportTextDelimitedCommand
false by default, so if you want it, you will need to enable it
You can set certain options for the entire grid, for example if you set exportWithFormatter
it will evaluate the Formatter (when exist) output to export. The Grid Menu also has the "Export to CSV" enabled by default.
this.gridOptions = {
// set at the grid option level, meaning all column will evaluate the Formatter (when it has a Formatter defined)
exportOptions: {
exportWithFormatter: true
},
gridMenu: {
showExportCsvCommand: true, // true by default, so it's optional
showExportTextDelimitedCommand: true // false by default, so if you want it, you will need to enable it
}
};
Inside the column definition there are couple of flags you can set and also some behavior that should be aware of:
-
excludeFromExport
flag, which as it's name suggest will skip that column from the export -
exportWithFormatter
flag (same as Grid Options but this flag defined in the Column Definition has higher priority).- So basically, if
exportWithFormatter
is set to True in theexportOptions
of the Grid Options, but is set to False in the Column Definition, then the result will be False and will not evaluate it's Formatter.
- So basically, if
-
exportCustomFormatter
will let you choose a different Formatter when exporting- For example, you might have
formatter: Formatters.checkmark
but you want to see a boolean translated value, in this case you would define an extra property ofcustomFormatter: Formatters.translateBoolean
.
- For example, you might have
- you can set
exportCsvForceToKeepAsString
flag, this one will wrap the cell value into double quotes and add an equal sign in the front, this is especially useful on a column that could be turned into an exponential number by Excel. For example, we could have "1E06" and without this flag will become (1.0E06) in Excel, unless we enable the flag which will become="1E06"
which will keep it as a string, also note that it will be shown as "1E06" but if you click on the cell value, you will see="1E06"
- set
sanitizeDataExport
to remove any HTML/Script code from being export. For example if your value is<span class="fa fa-check">True</span>
will exportTrue
without any HTML (data is sanitized).- this flag can be used in the Grid Options (all columns) or in a Column Definition (per column).
- If you have a
headerKey
defined (for Translate (i18n)), it will use the translated value as the Header Title - The file will automatically have the UTF-8 BOM encoding so that it works with Latin and even Unicode characters (see UI Sample.
The UTF-8 BOM is a sequence of bytes (EF BB BF) that allows the reader to identify a file as being encoded in UTF-8.
this.columnDefinitions = [
{ id: 'id', name: 'ID', field: 'id',
excludeFromExport: true // skip the "id" column from the export
},
{ id: 'title', name: 'Title', field: 'id', headerKey: 'TITLE',
formatter: myCustomTitleFormatter,
exportWithFormatter: false // this Formatter will not be evaluated
},
{ id: 'start', name: 'Start', field: 'start',
headerKey: 'START',
formatter: Formatters.dateIso // this formatter will be used for the export
},
{ id: 'finish', name: 'Finish', field: 'start',
headerKey: 'FINISH',
formatter: Formatters.dateIso // this formatter will be used for the export
},
{ id: 'completed', name: 'Completed', field: 'completed', headerKey: 'COMPLETED',
formatter: Formatters.checkmark, // will display a checkmark icon in the UI
customFormatter: Formatters.translateBoolean, // will export a translated value, e.g. in French, True would show as 'Vrai'
}
];
this.gridOptions = {
// set at the grid option level, meaning all column will evaluate the Formatter (when it has a Formatter defined)
exportOptions: {
exportWithFormatter: true
}
};
What we can see from the example, is that it will use all Formatters (when exist) on this grid, except for the last column "Completed" since that column has explicitly defined exportWithFormatter: false
You can use the export from the Grid Menu and/or you can simply create your own buttons to export.
<button class="btn btn-default btn-sm" (click)="exportToFile('csv')">
Download to CSV
</button>
<button class="btn btn-default btn-sm" (click)="exportToFile('txt')">
Download to Text
</button>
The code below is just an example and it can be configured in many ways, the delimiter used can also be anything you want.
exportToFile(type = 'csv') {
this.exportService.exportToFile({
delimiter: (type === 'csv') ? DelimiterType.comma : DelimiterType.tab,
filename: 'myExport',
format: (type === 'csv') ? FileType.csv : FileType.txt
});
}
The Export to File handles all characters well, from Latin, to Unicode, to even Unicorn emoji, it all works with all browsers (Chrome
, Firefox
, even IE11
, I don't have access to other versions apart from that). Here's a demo
Contents
- Angular-Slickgrid Wiki
- Installation
- Styling
- Interfaces/Models
- Testing Patterns
- Column Functionalities
- Global Grid Options
- Localization
- Events
- Grid Functionalities
- Auto-Resize / Resizer Service
- Resize by Cell Content
- Composite Editor
- Context Menu
- Custom Tooltip
- Add/Delete/Update or Highlight item
- Dynamically Change Row CSS Classes
- Excel Copy Buffer
- Export to Excel
- Export to File (CSV/Txt)
- Grid State & Presets
- Grouping & Aggregators
- Row Detail
- SlickGrid Controls
- SlickGrid Plugins
- Pinning (frozen) of Columns/Rows
- Tree Data Grid
- SlickGrid & DataView objects
- Addons (controls/plugins)
- Backend Services