導入

Aspose.Cells FOSS for TypeScript は、開発者が TypeScript アプリケーションから直接 Excel スプレッドシートを作成、読み取り、変更、エクスポートできる、無料のオープンソースライブラリです。ライブラリは MIT ライセンスで、Microsoft Office やネイティブランタイムへの依存はありません――Windows、Linux、macOS で同一に動作します。

ライブラリは、Workbook、Worksheet、Cell、Style クラスを中心に構築されたクリーンな API を提供します。開発者はセルの値を書き込み、数式を設定し、フォントや塗りつぶしのスタイリングを適用し、チャートや図形を追加し、データ検証やオートフィルターを構成し、XLSX、CSV、JSON、Markdown、HTML など複数の形式へエクスポートできます。

1 つのコマンドでインストールし、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");

クイックスタート

ソースからパッケージをビルドする:

git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-TypeScript.git
cd Aspose.Cells-FOSS-for-TypeScript
npm install
npm run build

ワークブックを作成し、データを書き込み、スタイリングを適用して、保存します:

import { Workbook, Style } from "excel-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 ライセンスの条件の下で許可されています。


はじめに

関連リソース