はじめに
Aspose.Cells FOSS for TypeScript は、基本的なセルの読み書きを超える包括的なスプレッドシート管理機能を提供します。開発者は、詳細なスタイリングを適用し、データ検証ルールを設定し、オートフィルターを構成し、条件付き書式を追加し、チャートを作成し、シェイプを挿入し、ブックを保護できます――すべて Microsoft Office に依存せずに TypeScript コードから実行できます。
この投稿では、ライブラリで利用可能な主要なスプレッドシート管理機能を順に解説し、各機能領域の動作するコード例を示します。
主な機能
データ検証
DataValidation クラスを使用してセル範囲に検証ルールを追加します。サポートされている検証タイプには、リスト、数値範囲、カスタム数式が含まれます。worksheet.addDataValidation() を使用して任意の範囲に検証を適用します。
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const validation = new DataValidation();
validation.type = "list";
validation.formula1 = '"Option1,Option2,Option3"';
worksheet.addDataValidation(validation, "B1:B10");
await workbook.save("validated.xlsx");
オートフィルタ
worksheet.setAutoFilter() を使用してデータ範囲にオートフィルタヘッダーを有効にします。これにより、出力XLSXファイルの列ヘッダーにドロップダウンフィルタコントロールが追加されます。worksheet.removeAutoFilter() を使用してフィルタを削除します。
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Name");
worksheet.putValue("B1", "Age");
worksheet.putValue("C1", "City");
worksheet.putValue("A2", "Alice");
worksheet.putValue("B2", "25");
worksheet.putValue("C2", "New York");
worksheet.putValue("A3", "Bob");
worksheet.putValue("B3", "30");
worksheet.putValue("C3", "London");
worksheet.setAutoFilter("A1:C4");
await workbook.save("filtered.xlsx");
条件付き書式
ConditionalFormatCollection を使用してセル範囲にビジュアルルールを適用します。ライブラリは ColorScaleRule、DataBarRule、および IconSetRule をサポートしており、セルの値に基づいてハイライトします。
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
for (let i = 1; i <= 10; i++) {
worksheet.putValue(`A${i}`, i * 10);
}
await workbook.save("conditional.xlsx");
ハイパーリンクとコメント
cell.setHyperlink() を使用して、URL、メールアドレス、内部シート参照をサポートするハイパーリンクをセルに添付します。worksheet.addComment() を使用し、Comment オブジェクトでコメントを追加します。
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Click here");
worksheet.getCell2("A1").setHyperlink("https://www.example.com");
worksheet.putValue("A3", "Send email");
worksheet.getCell2("A3").setHyperlink("mailto:test@example.com");
await workbook.save("hyperlinks.xlsx");
ワークブックとセルの保護
workbook.protect() を使用してパスワードでブック全体を保護します。style.setLocked(true) で個々のセルをロックし、style.setHidden() で数式の表示を制御します。
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Protected Cell");
const style = new Style();
style.setLocked(true);
style.setHidden(false);
worksheet.getCell2("A1").setStyle(style);
workbook.protect(true, "password");
await workbook.save("protected.xlsx");
列と行のサイズ設定
worksheet.setColumnWidth() を使用して列幅を設定し、worksheet.setRowHeight() を使用して行の高さを設定します。worksheet.setRowHidden() で行を非表示にします。これらの設定は保存された XLSX ファイルに保持されます。
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Wide Column");
worksheet.setColumnWidth(0, 30);
worksheet.setRowHeight(0, 25);
await workbook.save("sized.xlsx");
クイックスタート
npmでインストール:
npm install @aspose/cells@1.0.0
検証とオートフィルタを備えたスタイル付きワークブックを作成する:
import { Workbook, Style, DataValidation } from "@aspose/cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Status");
worksheet.putValue("B1", "Value");
const headerStyle = new Style();
headerStyle.setBold(true);
worksheet.getCell2("A1").setStyle(headerStyle);
worksheet.getCell2("B1").setStyle(headerStyle);
const validation = new DataValidation();
validation.type = "list";
validation.formula1 = '"Active,Inactive,Pending"';
worksheet.addDataValidation(validation, "A2:A20");
worksheet.setAutoFilter("A1:B20");
await workbook.save("managed.xlsx");
オープンソースとライセンス
Aspose.Cells FOSS for TypeScript は MIT ライセンスの下でリリースされています。ソースコードは GitHub で入手可能です。商用利用は MIT ライセンスの条件に従って許可されています。
