Bevezetés

Aspose.Cells FOSS a TypeScript számára a funkcionalitását egy kompakt alaposztály-készlettel teszi elérhetővé: Workbook, WorksheetCollection, Worksheet, Cell és Style, valamint formázáshoz és szűréshez kapcsolódó típusokkal. Ez a bejegyzés egy rendszerszerű körút a core API felületén – nem egy szűk téma, hanem azok az alapok, amelyeket minden, a könyvtárra épülő alkalmazás használ: munkafüzetek megnyitása és mentése, munkalapok navigálása, cellaértékek és képletek olvasása és írása, stílusok alkalmazása, adatok szűrése, és exportálás más formátumokba.

Az alábbi minden szakasz a API egy területét tárgyalja, a konkrét módszerekkel és tulajdonságokkal, működő TypeScript példákkal alátámasztva. A cél, hogy egy működő mentális modellt nyújtsunk arról, hogyan illeszkednek egymáshoz a részek, a new Workbook()-tól az egyedi Cell tulajdonságokig.

Kulcsfontosságú jellemzők

Munkafüzet és munkalap alapjai

A Workbook vagy üresen jön létre a new Workbook() segítségével, vagy aszinkron módon betöltődik egy meglévő fájlból a Workbook.load(filePath, password) használatával. Minden munkafüzet elérhetővé teszi a worksheets, egy WorksheetCollection, amely támogatja az indexelést, iterációt és a tömb-szerű metódusokat (map, filter, forEach, find, indexOf) továbbá a addWorksheet(name), removeWorksheet(index) és moveWorksheet(fromIndex, toIndex) funkciókat. Hívja a workbook.save(filePath, options) metódust a változások mentéséhez.

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ához való hozzáférés és értékek

A Worksheet cellákat olvas és ír a(z) putValue(key, value), getCell2(key) (visszaad egy Cell, ha hiányzik, létrehozza), getCell(row, col) (visszaad Cell | undefined), és getCellByRef(ref) segítségével. Minden Cell elérhetővé teszi a value, formula, row, col és ref tulajdonságként, valamint a setFormula() / setStyle() / setHyperlink() metódusokként.

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

Stílus, Betűtípus, Szegély és Igazítás

Style csoportosítja a betűtípust, kitöltést, szegélyt, igazítást és a számformátum beállításait egy cellához. Olvass vagy cserélj ki teljes al-objektumokat a(z) getFont()/setFont(), getBorder()/setBorder() és getAlignment()/setAlignment() segítségével, vagy használd a kényelmi beállítókat közvetlenül a(z) Style-on, például a(z) setFontName(), setFontSize(), setBold(), setHorizontalAlignment() és setNumberFormat(). Alkalmazd a kész Style egy cellára a(z) Cell.setStyle() használatával.

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

Automatikus szűrés a(z) AutoFilter osztállyal

Worksheet.setAutoFilter(range) egy rövidítés a gyakori esethez, de az alapszintű AutoFilter osztály is használható közvetlenül: hozd létre egy tartománnyal, majd hívd a(z) addFilterColumn(col, filters, blank) oszloponként, hogy meghatározd, mely értékek maradjanak láthatóak, vagy a(z) removeFilterColumn(col) / clear() a szűrés visszavonásához.

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

Exportálás HTML, CSV, JSON és Markdown

A .xlsx mellett egy Workbook közvetlenül szövegként is megjeleníthető a(z) toHtml(), toCsv(), toJson() és toMarkdown() segítségével, vagy elmenthető egy olyan fájlba, amelynek kiterjesztése a SaveFormat felsoroló típus (enum) alapján választja ki a formátumot (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");

Gyors kezdés

git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-TypeScript.git
cd Aspose.Cells-FOSS-for-TypeScript
npm install
npm run build
import { 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);

Támogatott formátumok

FormátumKiterjesztésOlvasásÍrás
XLSX.xlsx✓✓
HTML.html✓✓
CSV.csv—✓
JSON.json—✓
Markdown.md—✓

Nyílt forráskód & licencelés

Aspose.Cells FOSS a TypeScript számára MIT licenc alatt kerül kiadásra. A forráskód elérhető itt: GitHub. A kereskedelmi használat megengedett az MIT licenc feltételei szerint.

Első lépések

Kapcsolódó források