Introducció
Aspose.Cells FOSS for TypeScript és una biblioteca gratuïta i de codi obert que permet als desenvolupadors crear, llegir, modificar i exportar fulls de càlcul Excel directament des d’aplicacions TypeScript. La biblioteca té llicència MIT i no té cap dependència de Microsoft Office ni cap entorn d’execució natiu – s’executa de manera idèntica a Windows, Linux i macOS.
La llibreria ofereix una API neta construïda al voltant de les classes Workbook, Worksheet, Cell i Style. Els desenvolupadors poden escriure valors de cel·la, establir fórmules, aplicar estil de tipografia i farciment, afegir gràfics i formes, configurar la validació de dades i els filtres automàtics, i exportar a diversos formats, inclosos XLSX, CSV, JSON, Markdown i HTML.
Instal·la amb una sola ordre i comença a crear fluxos d’automatització de fulls de càlcul, generadors d’informes i eines d’exportació de dades sense cap dependència d’Office.
Característiques clau
Llegir i escriure fitxers XLSX
Carregueu llibres de treball existents amb Workbook.load() i deseu amb workbook.save(). Els valors de les cel·les, les fórmules i els estils es mantenen en un viatge d’anada i tornada a través de XLSX sense pèrdua. La classe WorksheetCollection admet la creació, supressió i reordenació de fulls de càlcul.
const workbook = await Workbook.load("input.xlsx");
const worksheet = workbook.worksheets[0]!;
console.log("A1:", worksheet.getCell(0, 0)?.value);
worksheet.putValue("B1", "Updated");
await workbook.save("output.xlsx");
Valors de cel·les i fórmules
Escriu enters, decimals i cadenes amb worksheet.putValue(). Defineix fórmules amb cell.setFormula() – la cadena de la fórmula s’emmagatzema literalment al fitxer XLSX i s’avalua per Excel o LibreOffice en obrir-lo.
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("formulas.xlsx");
Estil de Font i Emplenament
Aplica negreta, cursiva, mida de lletra, nom de lletra i color de lletra utilitzant la classe Style. Cada cel·la pot tenir el seu propi estil independent aplicat mitjançant cell.setStyle().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setFontColor("FF0000");
const cell = worksheet.getCell2("A1");
cell.putValue("Styled Text");
cell.setStyle(style);
await workbook.save("styled.xlsx");
Exportació multiformat
Exporta els llibres de treball a CSV, JSON, Markdown i HTML utilitzant mètodes dedicats a Workbook: toCsv(), toJson(), toMarkdown() i toHtml(). Alternativament, passa una ruta de fitxer amb l’extensió desitjada a workbook.save().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Name");
worksheet.putValue("B1", "Age");
worksheet.putValue("A2", "Alice");
worksheet.putValue("B2", 25);
await workbook.save("data.csv");
await workbook.save("data.json");
await workbook.save("data.md");
Inici ràpid
Instal·la el paquet amb npm:
npm install @aspose/cells@1.0.0
Creeu un llibre de treball, escriviu dades, apliqueu estil i deseu:
import { Workbook, Style } from "@aspose/cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Product");
worksheet.putValue("B1", "Revenue");
worksheet.putValue("A2", "Widget");
worksheet.putValue("B2", 42000);
worksheet.putValue("A3", "Gadget");
worksheet.putValue("B3", 31500);
const headerStyle = new Style();
headerStyle.setBold(true);
headerStyle.setFontSize(12);
worksheet.getCell2("A1").setStyle(headerStyle);
worksheet.getCell2("B1").setStyle(headerStyle);
worksheet.setAutoFilter("A1:B3");
await workbook.save("report.xlsx");
Formats compatibles
| Format | Extensió | Lectura | Escriptura |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
| HTML | .html | ✓ | ✓ |
Codi obert i llicències
Aspose.Cells FOSS per TypeScript es publica sota la llicència MIT. El codi font està allotjat a GitHub i accepta informes d’errors i pull requests. L’ús comercial està permès segons els termes de la llicència MIT.
