Introduction
Aspose.Cells FOSS for TypeScript est une bibliothèque gratuite et open‑source qui permet aux développeurs de créer, lire, modifier et exporter des feuilles de calcul Excel directement depuis des applications TypeScript. La bibliothèque est sous licence MIT et n’a aucune dépendance à Microsoft Office ou à un runtime natif – elle s’exécute de façon identique sous Windows, Linux et macOS.
La bibliothèque fournit une API propre construite autour des classes Workbook, Worksheet, Cell et Style. Les développeurs peuvent écrire des valeurs de cellules, définir des formules, appliquer des styles de police et de remplissage, ajouter des graphiques et des formes, configurer la validation des données et les filtres automatiques, et exporter vers plusieurs formats, notamment XLSX, CSV, JSON, Markdown et HTML.
Installez avec une seule commande et commencez à créer des pipelines d’automatisation de feuilles de calcul, des générateurs de rapports et des outils d’exportation de données sans aucune dépendance à Office.
Fonctionnalités clés
Lire et écrire des fichiers XLSX
Chargez les classeurs existants avec Workbook.load() et enregistrez‑les avec workbook.save(). Les valeurs de cellules, les formules et les styles sont conservés lors du round‑trip via XLSX sans perte. La classe WorksheetCollection prend en charge la création, la suppression et le réarrangement des feuilles de calcul.
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");
Valeurs de cellules et formules
Écrivez des entiers, des décimaux et des chaînes avec worksheet.putValue(). Définissez des formules avec cell.setFormula() – la chaîne de formule est stockée telle quelle dans le fichier XLSX et évaluée par Excel ou LibreOffice lors de l’ouverture.
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");
Style de police et de remplissage
Appliquez le gras, l’italique, la taille de police, le nom de police et la couleur de police en utilisant la classe Style. Chaque cellule peut avoir son propre style indépendant appliqué via 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");
Export multi-format
Exportez les classeurs au format CSV, JSON, Markdown et HTML en utilisant les méthodes dédiées sur Workbook : toCsv(), toJson(), toMarkdown() et toHtml(). Alternativement, transmettez un chemin de fichier avec l’extension souhaitée à 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");
Démarrage rapide
Installez le package avec npm :
npm install @aspose/cells@1.0.0
Créer un classeur, écrire des données, appliquer le style et enregistrer :
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 pris en charge
| Format | Extension | Lecture | Écriture |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
| HTML | .html | ✓ | ✓ |
Open Source et licences
Aspose.Cells FOSS pour TypeScript est publié sous licence MIT. Le code source est hébergé sur GitHub et accepte les rapports de bugs et les demandes de tirage. L’utilisation commerciale est autorisée selon les termes de la licence MIT.
