Inleiding
Aspose.Cells FOSS voor TypeScript onthult zijn functionaliteit via een compact geheel van kernklassen: Workbook, WorksheetCollection, Worksheet, Cell en Style, plus ondersteunende types voor opmaak en filteren. Dit bericht is een systematische rondleiding door die kern API oppervlakte — geen enkel smal onderwerp, maar de basisprincipes die elke applicatie die op de bibliotheek is gebouwd uiteindelijk gebruikt: werkboeken openen en opslaan, werkbladen navigeren, celwaarden en formules lezen en schrijven, stijlen toepassen, gegevens filteren en exporteren naar andere formaten.
Elke sectie hieronder behandelt één gebied van de API met de concrete methoden en eigenschappen die erbij horen, ondersteund door werkende TypeScript voorbeelden. Het doel is je een werkbaar mentaal model te geven van hoe de onderdelen in elkaar passen, van new Workbook() tot individuele Cell eigenschappen.
Belangrijkste functies
Workbook en Worksheet basisprincipes
Een Workbook wordt ofwel leeg aangemaakt met new Workbook() of asynchroon geladen vanuit een bestaand bestand met Workbook.load(filePath, password). Elke workbook maakt worksheets beschikbaar, een WorksheetCollection die indexering, iteratie en array-achtige methoden (map, filter, forEach, find, indexOf) ondersteunt, naast addWorksheet(name), removeWorksheet(index) en moveWorksheet(fromIndex, toIndex). Roep workbook.save(filePath, options) aan om wijzigingen op te slaan.
const workbook = new Workbook();
const ws1 = workbook.worksheets.addWorksheet();
const ws2 = workbook.worksheets.addWorksheet("CustomSheet1");
console.log("Total worksheets:", workbook.worksheets.length);
workbook.worksheets.removeWorksheet(1);
console.log("After delete:", workbook.worksheets.length);
console.log(
"Names:",
workbook.worksheets.worksheets.map((w) => w.name),
);
await workbook.save("workbook.xlsx");
Cell-toegang en waarden
Een Worksheet leest en schrijft cellen via putValue(key, value), getCell2(key) (geeft een Cell terug, maakt deze aan indien afwezig), getCell(row, col) (geeft Cell | undefined terug), en getCellByRef(ref). Elke Cell stelt value, formula, row, col en ref beschikbaar als eigenschappen, en setFormula() / setStyle() / setHyperlink() als methoden.
const workbook = new Workbook();
const sheet = workbook.worksheets[0]!;
sheet.putValue("A1", 42);
sheet.putValue("A2", "Hello World");
const formulaCell = sheet.getCell2("A3");
formulaCell.setFormula("=A1+10");
console.log("A1 value:", sheet.getCell(0, 0)?.value);
console.log("A3 formula:", sheet.getCell(2, 0)?.formula);
const byRef = sheet.getCellByRef("A1");
console.log("Ref:", byRef?.ref, "Row:", byRef?.row, "Col:", byRef?.col);
await workbook.save("cells.xlsx");
Stijl, Lettertype, Rand en Uitlijning
Style groepeert lettertype, opvulling, rand, uitlijning en getalnotatie-instellingen voor een cel. Lees of vervang volledige subobjecten met getFont()/setFont(), getBorder()/setBorder() en getAlignment()/setAlignment(), of gebruik de gemaksetter rechtstreeks op Style, zoals setFontName(), setFontSize(), setBold(), setHorizontalAlignment() en setNumberFormat(). Pas de voltooide Style toe op een cel met Cell.setStyle().
const workbook = new Workbook();
const sheet = workbook.worksheets[0]!;
const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setNumberFormat("0.00");
style.getBorder().bottom = { style: "thin", color: "000000" };
style.setHorizontalAlignment("center");
style.setVerticalAlignment("center");
style.setWrapText(true);
const cell = sheet.getCell2("B2");
cell.putValue(1234.5);
cell.setStyle(style);
console.log("Bold:", style.isBold(), "Format:", style.getNumberFormat());
await workbook.save("styled.xlsx");
Auto-filteren met de AutoFilter klasse
Worksheet.setAutoFilter(range) is een snelkoppeling voor het veelvoorkomende geval, maar de onderliggende AutoFilter klasse kan ook direct worden gebruikt: maak deze aan met een bereik, roep vervolgens addFilterColumn(col, filters, blank) per kolom aan om te definiëren welke waarden zichtbaar moeten blijven, of removeFilterColumn(col) / clear() om filtering ongedaan te maken.
const workbook = new Workbook();
const sheet = workbook.worksheets[0]!;
sheet.putValue("A1", "Name");
sheet.putValue("B1", "City");
sheet.putValue("A2", "Alice");
sheet.putValue("B2", "New York");
sheet.putValue("A3", "Bob");
sheet.putValue("B3", "London");
const filter = new AutoFilter("A1:B3");
filter.addFilterColumn(1, ["New York"], false);
console.log("Filter range:", filter.range);
console.log("Filter columns:", filter.columns.length);
await workbook.save("filtered.xlsx");
Exporteren naar HTML, CSV, JSON en Markdown
Naast .xlsx kan een Workbook zichzelf direct renderen als tekst met toHtml(), toCsv(), toJson() en toMarkdown(), of worden opgeslagen in een bestand waarvan de extensie het formaat selecteert via de SaveFormat enum (XLSX, CSV, JSON, MARKDOWN, HTML).
const workbook = new Workbook();
const sheet = workbook.worksheets[0]!;
sheet.putValue("A1", "Name");
sheet.putValue("B1", "Age");
sheet.putValue("A2", "Alice");
sheet.putValue("B2", 25);
sheet.putValue("A3", "Bob");
sheet.putValue("B3", 30);
console.log("JSON:", workbook.toJson());
console.log("Markdown:\n", workbook.toMarkdown());
await workbook.save("report.csv");
await workbook.save("report.html");
Snelstart
git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-TypeScript.git
cd Aspose.Cells-FOSS-for-TypeScript
npm install
npm run buildimport { Workbook, Style } from "excel-cells";
const workbook = new Workbook();
const sheet = workbook.worksheets.get(0)!;
sheet.name = "Summary";
sheet.putValue("A1", "Item");
sheet.putValue("B1", "Count");
sheet.putValue("A2", "Widgets");
sheet.putValue("B2", 12);
sheet.putValue("A3", "Gadgets");
sheet.putValue("B3", 7);
const totalCell = sheet.getCell2("B4");
totalCell.setFormula("=SUM(B2:B3)");
const numberStyle = new Style();
numberStyle.setNumberFormat("0");
sheet.getCell2("B2").setStyle(numberStyle);
sheet.getCell2("B3").setStyle(numberStyle);
sheet.getCell2("B4").setStyle(numberStyle);
const detail = workbook.worksheets.addWorksheet("Detail");
detail.putValue("A1", "Raw Data");
await workbook.save("summary.xlsx");
const reloaded = await Workbook.load("summary.xlsx");
console.log("Worksheets:", reloaded.worksheets.length);
console.log("B4 formula:", reloaded.worksheets.get(0)!.getCell(3, 1)?.formula);
Ondersteunde formaten
| Formaat | Extensie | Lezen | Schrijven |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| HTML | .html | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
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.
