Introductie
Aspose.Cells FOSS for TypeScript biedt een uitgebreide reeks spreadsheet‑beheermogelijkheden die verder gaan dan basiscel lezen/schrijven. Ontwikkelaars kunnen gedetailleerde opmaak toepassen, gegevensvalidatieregels instellen, auto‑filters configureren, voorwaardelijke opmaak toevoegen, grafieken maken, vormen invoegen en werkmappen beveiligen – allemaal vanuit TypeScript‑code zonder afhankelijkheid van Microsoft Office.
Deze post loopt de belangrijkste spreadsheet‑beheerfuncties die in de bibliotheek beschikbaar zijn door, met werkende codevoorbeelden voor elk functiegebied.
Belangrijkste kenmerken
Gegevensvalidatie
Voeg validatieregels toe aan celbereiken met behulp van de DataValidation-klasse. Ondersteunde validatietypen omvatten lijst, numeriek bereik en aangepaste formules. Pas validatie toe op elk bereik met 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
Schakel auto-filterkoppen in op een gegevensbereik met worksheet.setAutoFilter(). Dit voegt vervolgkeuzefilterbesturingselementen toe aan kolomkoppen in het uitvoer‑XLSX‑bestand. Verwijder filters met 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");
Voorwaardelijke opmaak
Pas visuele regels toe op celbereiken met ConditionalFormatCollection. De bibliotheek ondersteunt ColorScaleRule, DataBarRule en IconSetRule voor het markeren van cellen op basis van hun waarden.
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 en Opmerkingen
Voeg hyperlinks toe aan cellen met cell.setHyperlink() die URL’s, e‑mailadressen en interne bladverwijzingen ondersteunen. Voeg opmerkingen toe met worksheet.addComment() met behulp van Comment objecten.
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");
Werkmap- en celbeveiliging
Bescherm volledige werkboeken met een wachtwoord met behulp van workbook.protect(). Vergrendel individuele cellen met style.setLocked(true) en beheer de zichtbaarheid van formules met 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");
Kolom- en rijgrootte
Stel kolombreedtes in met worksheet.setColumnWidth() en rijhoogtes met worksheet.setRowHeight(). Verberg rijen met worksheet.setRowHidden(). Deze instellingen blijven behouden in het opgeslagen XLSX‑bestand.
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");
Snelstart
Installeer met npm:
npm install @aspose/cells@1.0.0
Maak een gestileerd werkboek met validatie en 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 & licenties
Aspose.Cells FOSS voor TypeScript is uitgebracht onder de MIT-licentie. De broncode is beschikbaar op GitHub. Commercieel gebruik is toegestaan onder de voorwaarden van de MIT-licentie.
