Angular Excel ライブラリの概要

Infragistics Angular Excel ライブラリは、Workbook、Worksheet、Cell、Formula などの人気の Microsoft® Excel® スプレッドシート オブジェクトを使用してスプレッドシート データで作業をすることができます。Infragistics Angular Excel ライブラリによって Excel スプレッドシートでアプリケーションのデータを表示するだけでなく、Excel からアプリケーションへのデータの転送も簡単になります。

Angular Excel ライブラリの例

依存関係

excel パッケージをインストールするときに core パッケージもインストールする必要があります。

npm install --save igniteui-angular-core
npm install --save igniteui-angular-excel

モジュールの要件

Angular Excel ライブラリを使用するには、以下のモジュールが必要です。

// app.module.ts
import { IgxExcelModule } from 'igniteui-angular-excel';

@NgModule({
    imports: [
        // ...
        IgxExcelModule,
        // ...
    ]
})
export class AppModule {}

モジュールの実装

Excel ライブラリには、アプリのバンドル サイズを制限するために使用できる 5 つのモジュールが含まれています。

• IgxExcelCoreModule – オブジェクトモデルを含み、Excel の基盤となります。
• IgxExcelFunctionsModule – Sum、Average、Min、Max などの、数式評価に使用する関数の大部分を含みます。このモジュールがない場合でも、数式のパース自体は問題なく動作しますが、数式を実際に計算しようとすると問題が生じます。たとえば “=SUM(A1:A5)” のような数式を設定してセルの Value を取得しようとした場合、#NAME! エラーが返されます。(数式がエラー結果を返す場合、例外のスローではなく特定のエラーを表すオブジェクトとして返されます。)
• IgxExcelXlsModule – xls (および関連する) 形式のファイルの読み込みと保存のロジックを含みます。これは Excel97to2003 関連の WorkbookFormats です。
• IgxExcelXlsxModule – xlsx (および関連する) 形式のファイルの読み込みと保存のロジックを含みます。これは Excel2007 関連および StrictOpenXml の WorkbookFormats です。
• IgxExcelModule – 上記 4 つのモジュールの参照で、すべての機能の読み込み/使用を可能にします。

サポートされるバージョンの Microsoft Excel

以下は Excel のサポートされるバージョンのリストです。

• Microsoft Excel 97

• Microsoft Excel 2000

• Microsoft Excel 2002

• Microsoft Excel 2003

• Microsoft Excel 2007

• Microsoft Excel 2010

• Microsoft Excel 2013

• Microsoft Excel 2016

ワークブックの読み込みと保存

Excel ライブラリ モジュールをインポートした後、ワークブックを読み込みます。

次のコード スニペットでは、外部の ExcelUtility クラスを使用して Workbook の保存および読み込みを行っています。

Workbook オブジェクトを読み込んで保存するために、実際の Workbook の Save メソッドや static な Load メソッドを使用できます。

import { Workbook } from "igniteui-angular-excel";
import { WorkbookSaveOptions } from "igniteui-angular-excel";
import { WorkbookFormat } from "igniteui-angular-excel";
import { ExcelUtility } from "ExcelUtility";

var workbook = ExcelUtility.load(file);
ExcelUtility.save(workbook, "fileName");

ヒープの管理

Excel ライブラリのサイズ最適化のため、ソース マップの生成を無効にすることをお勧めします。

angular.json を変更して、architect => build => options と serve => options の下にある vendorSourceMap オプションを設定します:

    "architect": {
        "build": {
          "builder": "...",
          "options": {
            "vendorSourceMap": false,
            "outputPath": "dist",
            "index": "src/index.html",
            "main": "src/main.ts",
            "tsConfig": "src/tsconfig.app.json",
                  // ...
          },
              // ...
        },
        "serve": {
          "builder": "...",
          "options": {
            "vendorSourceMap": false,
            "browserTarget": "my-app:build"
          },
              // ...
        },
        // ...
      }

API リファレンス