Einleitung

Aspose.Cells FOSS for TypeScript bietet einen umfassenden Satz von Tabellenkalkulationsverwaltungsfunktionen, die über das grundlegende Lesen/Schreiben von Zellen hinausgehen. Entwickler können detaillierte Formatierungen anwenden, Datenvalidierungsregeln einrichten, Auto‑Filter konfigurieren, bedingte Formatierung hinzufügen, Diagramme erstellen, Formen einfügen und Arbeitsmappen schützen – alles aus TypeScript‑Code ohne Microsoft Office‑Abhängigkeit.

Dieser Beitrag führt durch die wichtigsten Tabellenkalkulationsverwaltungsfunktionen, die in der Bibliothek verfügbar sind, und enthält funktionierende Codebeispiele für jeden Funktionsbereich.

Hauptmerkmale

Datenvalidierung

Fügen Sie Zellbereichen Validierungsregeln mit der DataValidation‑Klasse hinzu. Unterstützte Validierungstypen umfassen Liste, Zahlenbereich und benutzerdefinierte Formeln. Wenden Sie die Validierung auf jeden Bereich mit worksheet.addDataValidation() an.

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");

Auto-Filter

Aktivieren Sie Auto‑Filter‑Header für einen Datenbereich mit worksheet.setAutoFilter(). Dies fügt Dropdown‑Filtersteuerelemente zu den Spaltenüberschriften in der ausgegebenen XLSX‑Datei hinzu. Entfernen Sie Filter mit 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");

Bedingte Formatierung

Wenden Sie visuelle Regeln auf Zellbereiche mit ConditionalFormatCollection an. Die Bibliothek unterstützt ColorScaleRule, DataBarRule und IconSetRule zum Hervorheben von Zellen basierend auf deren Werten.

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");

Fügen Sie Hyperlinks zu Zellen mit cell.setHyperlink() unterstützenden URLs, E‑Mail‑Adressen und internen Blattverweisen hinzu. Fügen Sie Kommentare mit worksheet.addComment() unter Verwendung von Comment‑Objekten hinzu.

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");

Arbeitsmappe und Zellenschutz

Schützen Sie gesamte Arbeitsmappen mit einem Passwort mithilfe von workbook.protect(). Sperren Sie einzelne Zellen mit style.setLocked(true) und steuern Sie die Sichtbarkeit von Formeln mit 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");

Spalten- und Zeilengrößen

Stellen Sie Spaltenbreiten mit worksheet.setColumnWidth() und Zeilenhöhen mit worksheet.setRowHeight() ein. Verstecken Sie Zeilen mit worksheet.setRowHidden(). Diese Einstellungen bleiben in der gespeicherten XLSX-Datei erhalten.

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");

Schnellstart

Installation mit npm:

npm install @aspose/cells@1.0.0

Erstellen Sie eine formatierte Arbeitsmappe mit Validierung und Auto‑Filter:

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");

Open Source & Lizenzierung

Aspose.Cells FOSS für TypeScript wird unter der MIT-Lizenz veröffentlicht. Der Quellcode ist auf GitHub verfügbar. Die kommerzielle Nutzung ist gemäß den Bedingungen der MIT-Lizenz gestattet.

Erste Schritte

Verwandte Ressourcen