Introduzione
Aspose.Cells FOSS per TypeScript è una libreria gratuita e open‑source che consente agli sviluppatori di creare, leggere, modificare ed esportare fogli di calcolo Excel direttamente dalle applicazioni TypeScript. La libreria è rilasciata con licenza MIT e non ha dipendenze da Microsoft Office o da alcun runtime nativo – funziona identicamente su Windows, Linux e macOS.
La libreria fornisce un’API pulita costruita attorno alle classi Workbook, Worksheet, Cell e Style. Gli sviluppatori possono scrivere valori di cella, impostare formule, applicare stili di carattere e riempimento, aggiungere grafici e forme, configurare la convalida dei dati e i filtri automatici, ed esportare in più formati tra cui XLSX, CSV, JSON, Markdown e HTML.
Installa con un unico comando e inizia a creare pipeline di automazione dei fogli di calcolo, generatori di report e strumenti di esportazione dati senza alcuna dipendenza da Office.
Caratteristiche principali
Leggi e scrivi file XLSX
Carica cartelle di lavoro esistenti con Workbook.load() e salva con workbook.save(). I valori delle celle, le formule e gli stili vengono trasferiti in modo round‑trip tramite XLSX senza perdita. La classe WorksheetCollection supporta la creazione, la rimozione e il riordino dei fogli di lavoro.
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");
Valori di cella e formule
Scrivi interi, decimali e stringhe con worksheet.putValue(). Imposta formule con cell.setFormula() – la stringa della formula è memorizzata letteralmente nel file XLSX e valutata da Excel o LibreOffice all’apertura.
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");
Stile del Font e del Riempimento
Applica grassetto, corsivo, dimensione del carattere, nome del carattere e colore del carattere usando la classe Style. Ogni cella può avere il proprio stile indipendente applicato tramite 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");
Esportazione Multi-Formato
Esporta i workbook in CSV, JSON, Markdown e HTML usando i metodi dedicati su Workbook: toCsv(), toJson(), toMarkdown() e toHtml(). In alternativa, passa un percorso file con l’estensione desiderata 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");
Avvio rapido
Installa il pacchetto con npm:
npm install @aspose/cells@1.0.0
Crea una cartella di lavoro, scrivi i dati, applica lo stile e salva:
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");
Formati supportati
| Formato | Estensione | Lettura | Scrittura |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
| HTML | .html | ✓ | ✓ |
Open Source e Licenze
Aspose.Cells FOSS per TypeScript è rilasciato sotto licenza MIT. Il codice sorgente è ospitato su GitHub e accetta bug reports e pull requests. L’uso commerciale è consentito ai sensi dei termini della licenza MIT.
