9.0.0 • Published 4 years ago

mini-mat-table-exporter v9.0.0

Weekly downloads
1
License
Apache-2.0
Repository
github
Last release
4 years ago

Angular Material Table Exporter

JavaScript Style Guide: Good Parts Node version Total Downloads

This package is to make MatTable components exportable in excel, csv, txt and json formats. Pagination is also supported. Applying MatTableExporter directive to your MatTable is enough to make it exportable. The directive uses different exporter services for different exporting types. You can also implement your own exporter and use it for your custom exporting requirements.

This project employs xlsx sheetjs, which is a great library and mature enough for the excel creation itself. In order to achieve a cross-browser file saving capability FileSaverjs is employed.

The MatTableExporter directive inside this package is a mini-cdk-table-exporter subtype and provides support for angular material's cdkTable. mini-cdk-table-exporter facilitates the common exporting related functionalities for CdkTable implementations abstracting the behavior that can change among different CdkTables.

 

Getting Started

Angular Material Users

If you are employing angular material in your project. Install mini-mat-table-exporter

npm install --save mini-mat-table-exporter

NOTE: For the previous major versions of Angular install version 1.2.5

npm install --save mini-mat-table-exporter@1.2.5

After installing mini-mat-table-exporter import MatTableExporterModule in your ngModule

import { MatTableExporterModule } from 'mini-mat-table-exporter';

Other than Angular Material

Install mini-cdk-table-exporter if you are not using angular material in your project. In this case you have to implement your version of CdkTableExporter abstract class to use as your directive.

npm install --save mini-cdk-table-exporter

NOTE: For the previous major versions of Angular install version 1.2.5

npm install --save mini-cdk-table-exporter@1.2.5

After installing mini-cdk-table-exporter import CdkTableExporterModule in your ngModules

import { CdkTableExporterModule } from 'mini-cdk-table-exporter';

 

Usage

Angular Material Users

matTableExporter is the directive selector.

<mat-table matTableExporter [dataSource]="dataSource" #exporter="matTableExporter">
<button mat-button (click)="exporter.exportTable('csv')"></button>

 

* Stackblitz demo: mte-demo.
* Stackblitz demo of custom exporter mte-cex-demo.

 

##API

MatTableExporterDirective

Input/OutputPropertyTypeDescription
@InputhiddenColumnsArray<number>(Optional) The indexes of the columns that are not wanted in the output file
@InputexporterExporter<Options>(Optional) The actual exporting implementation that defines the strategy to be applied to the rows extracted from MatTable.
@OutputexportStartedEventEmitter<void>(Optional) Event that's fired when the export started
@OutputexportCompletedEventEmitter<void>(Optional) Event that's fired when the export completed

 

MethodDescription
exportTable(exportType?: ExportType, options?: Options)Called to trigger the export of MatTable

 

ExportType

export enum ExportType {
  XLS = 'xls',
  XLSX = 'xlsx',
  CSV = 'csv',
  TXT = 'txt',
  JSON = 'json',
  OTHER = 'other'
}

 

Options

PropertyTypeDescription
fileNamestring(Optional) Name of the exported file

 

ExcelOptions

ExcelOptions wraps the WritingOptions of sheetjs library. All other export types share the common Options interface. In the next releases, options will be enriched for the other export types.

PropertyTypeDescription
fileNamestring(Optional) Name of the exported file
type'base64', 'binary', 'buffer', 'file', 'array', 'string'(Optional) Output data encoding
bookSSTboolean(Optional) Generate Shared String Table @default false
sheetstring(Optional) Name of the exported sheet
compressionboolean(Optional) Use ZIP compression for ZIP-based formats @default false
ignoreECboolean(Optional) Suppress "number stored as text" errors in generated files @default true
PropsProperties(Optional) Workbook properties like Author, Title, Subject etc.
columnWidthsArray<number>(Optional) Column widths in maximum char

 

Licence

Apache-2.0