Úvod

Aspose.Cells FOSS for TypeScript poskytuje komplexnú sadu funkcií správy tabuľkových dokumentov nad rámec základného čítania/zápisu buniek. Vývojári môžu aplikovať podrobné štýlovanie, nastaviť pravidlá overovania údajov, konfigurovať automatické filtre, pridávať podmienené formátovanie, vytvárať grafy, vkladať tvary a chrániť zošity – všetko z TypeScript kódu bez závislosti na Microsoft Office.

Tento príspevok prechádza kľúčovými schopnosťami správy tabuľkových dokumentov dostupnými v knižnici, s pracovnými príkladmi kódu pre každú oblasť funkcií.

Kľúčové vlastnosti

Validácia údajov

Pridajte validačné pravidlá do rozsahov buniek pomocou triedy DataValidation. Podporované typy validácie zahŕňajú zoznam, číselný rozsah a vlastné vzorce. Použite validáciu na akýkoľvek rozsah pomocou 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");

Automatický filter

Povoliť automatické filtre hlavičiek v dátovom rozsahu pomocou worksheet.setAutoFilter(). Toto pridá rozbaľovacie ovládacie prvky filtra do hlavičiek stĺpcov v výstupnom súbore XLSX. Odstrániť filtre pomocou 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");

Podmienené formátovanie

Použite vizuálne pravidlá na rozsahy buniek pomocou ConditionalFormatCollection. Knižnica podporuje ColorScaleRule, DataBarRule a IconSetRule na zvýrazňovanie buniek na základe ich hodnôt.

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

Hyperlinky a komentáre

Pripojte hypertextové odkazy k bunkám s cell.setHyperlink() podporujúcimi URL, e‑mailové adresy a interné odkazy na hárky. Pridajte komentáre s worksheet.addComment() pomocou Comment objektov.

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

Ochrana zošita a buniek

Ochránte celé zošity heslom pomocou workbook.protect(). Zamknite jednotlivé bunky pomocou style.setLocked(true) a kontrolujte viditeľnosť vzorcov pomocou 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");

Veľkosť stĺpca a riadku

Nastavte šírky stĺpcov pomocou worksheet.setColumnWidth() a výšky riadkov pomocou worksheet.setRowHeight(). Skryte riadky pomocou worksheet.setRowHidden(). Tieto nastavenia zostanú v uloženom súbore 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");

Rýchly štart

Inštalovať pomocou npm:

npm install @aspose/cells@1.0.0

Vytvorte štýlovaný zošit s overovaním a automatickým filtrom:

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 a licencovanie

Aspose.Cells FOSS pre TypeScript je vydaný pod licenciou MIT. Zdrojový kód je dostupný na GitHub. Komerčné použitie je povolené podľa podmienok licencie MIT.

Začíname

Súvisiace zdroje