はじめに
Aspose.Cells FOSS for TypeScript は、開発者が TypeScript アプリケーションから直接 Excel スプレッドシートを作成、読み取り、変更、エクスポートできる、無料のオープンソース ライブラリです。このライブラリは MIT-licensed で提供されており、Microsoft Office や任意のネイティブ ランタイムに依存しません – Windows、Linux、macOS で同一に動作します。
このライブラリは、Workbook、Worksheet、Cell、Style クラスを中心に構築されたクリーンな API を提供します。開発者はセルの値を書き込んだり、数式を設定したり、フォントや塗りつぶしのスタイリングを適用したり、チャートやシェイプを追加したり、データ検証やオートフィルタを構成したり、XLSX、CSV、JSON、Markdown、HTML などの複数の形式にエクスポートしたりできます。
単一のコマンドでインストールし、Office への依存なしでスプレッドシート自動化パイプライン、レポートジェネレータ、データエクスポートツールの構築を開始できます。
主な機能
XLSX ファイルの読み取りと書き込み
Workbook.load() を使用して既存のブックをロードし、workbook.save() で保存します。セルの値、数式、スタイルは XLSX を介してロスなく往復します。WorksheetCollection クラスは、ワークシートの作成、削除、並び替えをサポートします。
const workbook = await Workbook.load("input.xlsx");
const worksheet = workbook.worksheets[0]!;
console.log("A1:", worksheet.getCell(0, 0)?.value);
worksheet.putValue("B1", "Updated");
await workbook.save("output.xlsx");
セルの値と数式
整数、少数、文字列はworksheet.putValue()で書き込みます。cell.setFormula()で数式を設定します – 数式文字列はXLSXファイルにそのまま保存され、開いたときにExcelまたはLibreOfficeで評価されます。
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", 42);
worksheet.putValue("A2", 3.14159);
worksheet.putValue("A3", "Hello World");
const cellA4 = worksheet.getCell2("A4");
cellA4.setFormula("=SUM(A1:A2)");
await workbook.save("formulas.xlsx");
フォントと塗りつぶしのスタイリング
Style クラスを使用して太字、斜体、フォントサイズ、フォント名、フォントカラーを適用します。各セルは cell.setStyle() を介して独自のスタイルを適用できます。
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setFontColor("FF0000");
const cell = worksheet.getCell2("A1");
cell.putValue("Styled Text");
cell.setStyle(style);
await workbook.save("styled.xlsx");
マルチフォーマット エクスポート
Workbook の専用メソッドを使用して、ワークブックを CSV、JSON、Markdown、HTML にエクスポートします: toCsv()、toJson()、toMarkdown()、および toHtml()。あるいは、希望する拡張子を持つファイルパスを workbook.save() に渡します。
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Name");
worksheet.putValue("B1", "Age");
worksheet.putValue("A2", "Alice");
worksheet.putValue("B2", 25);
await workbook.save("data.csv");
await workbook.save("data.json");
await workbook.save("data.md");
クイックスタート
npmでパッケージをインストールします:
npm install @aspose/cells@1.0.0
ワークブックを作成し、データを書き込み、スタイルを適用して保存する:
import { Workbook, Style } from "@aspose/cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Product");
worksheet.putValue("B1", "Revenue");
worksheet.putValue("A2", "Widget");
worksheet.putValue("B2", 42000);
worksheet.putValue("A3", "Gadget");
worksheet.putValue("B3", 31500);
const headerStyle = new Style();
headerStyle.setBold(true);
headerStyle.setFontSize(12);
worksheet.getCell2("A1").setStyle(headerStyle);
worksheet.getCell2("B1").setStyle(headerStyle);
worksheet.setAutoFilter("A1:B3");
await workbook.save("report.xlsx");
サポートされている形式
| 形式 | 拡張子 | 読み取り | 書き込み |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
| HTML | .html | ✓ | ✓ |
オープンソースとライセンス
Aspose.Cells FOSS for TypeScript は MIT ライセンスの下でリリースされています。ソースコードは GitHub にホストされており、バグ報告やプルリクエストを受け付けています。商用利用は MIT ライセンスの条件に従って許可されています。
