Werken met Spreadsheetbeheer
Werkbladen beheren
De WorksheetCollection class biedt methoden voor het beheren van werkbladen binnen een werkmap. Voeg nieuwe werkbladen toe met addWorksheet(), verwijder ze met removeWorksheet(), en herschik ze met moveWorksheet().
import { Workbook } from "excel-cells";
const workbook = new Workbook();
const sheets = workbook.worksheets;
const sheet2 = sheets.addWorksheet("Sales");
const sheet3 = sheets.addWorksheet("Summary");
sheet2.putValue("A1", "Sales Data");
sheet3.putValue("A1", "Summary Report");
await workbook.save("multi-sheet.xlsx");Celwaarden en formules
Schrijf gehele getallen, decimalen en strings met worksheet.putValue(). Toegang tot cellen via referentie met getCell2() of via rij/kolom-index met getCell(). Stel formules in met cell.setFormula().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", 42);
worksheet.putValue("A2", 3.14159);
worksheet.putValue("A3", "Hello World");
const cellA4 = worksheet.getCell2("A4");
cellA4.setFormula("=SUM(A1:A2)");
await workbook.save("values.xlsx");Lettertype- en vulstyling
Pas lettertype-instellingen toe met de Style class. Stel lettertype, grootte, vet, cursief en kleur in. Pas de stijl toe op individuele cellen met cell.setStyle().
import { Workbook, Style } from "excel-cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setItalic(true);
style.setFontColor("FF0000");
const cell = worksheet.getCell2("A1");
cell.putValue("Styled Text");
cell.setStyle(style);
await workbook.save("styled.xlsx");Gegevensvalidatie
Voeg validatieregels toe aan celbereiken met DataValidation. Specificeer het validatietype (lijst, getallenbereik of aangepast) en pas toe met worksheet.addDataValidation().
import { Workbook, DataValidation } from "excel-cells";
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 filterbare kolomkoppen in met worksheet.setAutoFilter(). 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.setAutoFilter("A1:C4");
await workbook.save("filtered.xlsx");Hyperlinks
Koppel hyperlinks aan cellen met cell.setHyperlink(). Ondersteunt URL’s, e-mailadressen en interne bladverwijzingen.
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");Werkboekbescherming
Bescherm werkboeken met een wachtwoord via workbook.protect(). Vergrendel individuele cellen met style.setLocked(true).
import { Workbook, Style } from "excel-cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Protected Cell");
const style = new Style();
style.setLocked(true);
worksheet.getCell2("A1").setStyle(style);
workbook.protect(true, "password");
await workbook.save("protected.xlsx");Kolom- en rijgrootte
Stel kolombreedtes en rijhoogtes in om de celafmetingen in het uitvoer-XLSX-bestand te regelen.
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");