クイックスタート

このガイドでは、TypeScript 用のコア Aspose.Cells FOSS ワークフローを順に説明します:ゼロからワークブックを作成し、既存の XLSX ファイルを読み込み、セルにスタイルを適用し、データを他の形式へエクスポートします。以下の各セクションは、ライブラリをソースからビルドした後に Node.js プロジェクトへコピーできる、自己完結型の例です。

ワークブックを作成する

新しい Workbook を作成し、worksheet.putValue() を使用してセルに型付けされた値(文字列と数値)を書き込み、結果を XLSX ファイルとして保存します:

import { Workbook } 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);

await workbook.save("report.xlsx");

既存のワークブックを読み込む

Workbook.load() で既存の XLSX ファイルを開き、次に worksheet.getCell() でセルの値を読み戻します。これは、他のツールで生成されたスプレッドシートデータを読み取る際の典型的なエントリーポイントです:

import { Workbook } from "excel-cells";

const workbook = await Workbook.load("report.xlsx");
const worksheet = workbook.worksheets[0]!;

const product = worksheet.getCell(0, 0)?.value;
const revenue = worksheet.getCell(0, 1)?.value;
console.log(`${product}: ${revenue}`);

スタイリングを適用する

Style オブジェクトを作成し、フォント設定(名前、サイズ、太字、色)を適用してから、cell.setStyle() でセルに割り当てます。スタイルは独立したオブジェクトなので、同じ Style インスタンスを多数のセルで再利用できます:

import { Workbook, Style } from "excel-cells";

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.save() を呼び出すと、同じデータを CSV、JSON、Markdown、または HTML にエクスポートできます — 別途変換ステップは不要です:

import { Workbook } from "excel-cells";

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.xlsx");
await workbook.save("data.csv");
await workbook.save("data.json");
await workbook.save("data.md");

参照

 日本語