Introduktion
Aspose.Cells FOSS for TypeScript leverer et omfattende sæt af regnearksadministrationsfunktioner ud over grundlæggende celle læs/skriv. Udviklere kan anvende detaljeret styling, opsætte datavalideringsregler, konfigurere autofilter, tilføje betinget formatering, opbygge diagrammer, indsætte former og beskytte projektmapper – alt fra TypeScript‑kode uden Microsoft Office‑afhængighed.
Dette indlæg gennemgår de vigtigste regnearksadministrationsfunktioner, der er tilgængelige i biblioteket, med fungerende kodeeksempler for hvert funktionområde.
Nøglefunktioner
Datavalidering
Tilføj valideringsregler til celleområder ved hjælp af DataValidation-klassen. Understøttede valideringstyper omfatter liste, talområde og brugerdefinerede formler. Anvend validering på ethvert område med 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");
Auto-Filter
Aktiver auto‑filter‑overskrifter på et dataområde med worksheet.setAutoFilter(). Dette tilføjer rullemenu‑filterkontroller til kolonneoverskrifter i den genererede XLSX‑fil. Fjern filtre med 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");
Betinget formatering
Anvend visuelle regler på celleområder ved hjælp af ConditionalFormatCollection. Biblioteket understøtter ColorScaleRule, DataBarRule og IconSetRule til at fremhæve celler baseret på deres værdier.
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");
Hyperlinks og kommentarer
Vedhæft hyperlinks til celler med cell.setHyperlink(), der understøtter URL’er, e‑mailadresser og interne arkreferencer. Tilføj kommentarer med worksheet.addComment() ved hjælp af Comment‑objekter.
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");
Projektmappe og cellebeskyttelse
Beskyt hele arbejdsbøger med en adgangskode ved hjælp af workbook.protect(). Lås individuelle celler med style.setLocked(true) og kontroller formelens synlighed med 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");
Kolonne- og rækkestørrelse
Indstil kolonnebredder med worksheet.setColumnWidth() og rækkehøjder med worksheet.setRowHeight(). Skjul rækker med worksheet.setRowHidden(). Disse indstillinger bevares i den gemte XLSX‑fil.
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");
Hurtig start
Installer med npm:
npm install @aspose/cells@1.0.0
Byg en formateret projektmappe med validering og autofilter:
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 & Licensering
Aspose.Cells FOSS for TypeScript er udgivet under MIT-licensen. Kildekoden er tilgængelig på GitHub. Kommerciel brug er tilladt i henhold til MIT-licensens vilkår.
