導入
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 ライセンスの条件の下で許可されています。