Introduction
Aspose.Cells FOSS for TypeScript fournit un ensemble complet de fonctionnalités de gestion de feuilles de calcul au‑delà de la lecture/écriture de cellules de base. Les développeurs peuvent appliquer un style détaillé, définir des règles de validation des données, configurer des filtres automatiques, ajouter une mise en forme conditionnelle, créer des graphiques, insérer des formes et protéger les classeurs – le tout depuis du code TypeScript sans dépendance à Microsoft Office.
Cet article passe en revue les principales capacités de gestion des feuilles de calcul disponibles dans la bibliothèque, avec des exemples de code fonctionnels pour chaque domaine de fonctionnalité.
Fonctionnalités clés
Validation des données
Ajoutez des règles de validation aux plages de cellules en utilisant la classe DataValidation. Les types de validation pris en charge incluent la liste, la plage de nombres et les formules personnalisées. Appliquez la validation à n’importe quelle plage avec worksheet.addDataValidation().
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");
Filtre automatique
Activer les en‑têtes de filtre automatique sur une plage de données avec worksheet.setAutoFilter(). Cela ajoute des contrôles de filtre déroulant aux en‑têtes de colonne dans le fichier XLSX de sortie. Supprimer les filtres avec 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.putValue("A3", "Bob");
worksheet.putValue("B3", "30");
worksheet.putValue("C3", "London");
worksheet.setAutoFilter("A1:C4");
await workbook.save("filtered.xlsx");
Mise en forme conditionnelle
Appliquez des règles visuelles aux plages de cellules en utilisant ConditionalFormatCollection. La bibliothèque prend en charge ColorScaleRule, DataBarRule et IconSetRule pour mettre en évidence les cellules en fonction de leurs valeurs.
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
for (let i = 1; i <= 10; i++) {
worksheet.putValue(`A${i}`, i * 10);
}
await workbook.save("conditional.xlsx");
Hyperliens et commentaires
Attachez des hyperliens aux cellules avec cell.setHyperlink() prenant en charge les URL, les adresses e‑mail et les références internes de feuille. Ajoutez des commentaires avec worksheet.addComment() en utilisant des objets Comment.
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");
Protection du classeur et des cellules
Protégez l’intégralité des classeurs avec un mot de passe en utilisant workbook.protect(). Verrouillez des cellules individuelles avec style.setLocked(true) et contrôlez la visibilité des formules avec style.setHidden().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Protected Cell");
const style = new Style();
style.setLocked(true);
style.setHidden(false);
worksheet.getCell2("A1").setStyle(style);
workbook.protect(true, "password");
await workbook.save("protected.xlsx");
Dimensionnement des colonnes et des lignes
Définissez les largeurs de colonnes avec worksheet.setColumnWidth() et les hauteurs de lignes avec worksheet.setRowHeight(). Masquez les lignes avec worksheet.setRowHidden(). Ces paramètres sont conservés dans le fichier XLSX enregistré.
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");
Démarrage rapide
Installer avec npm :
npm install @aspose/cells@1.0.0
Créer un classeur stylisé avec validation et filtre automatique :
import { Workbook, Style, DataValidation } from "@aspose/cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Status");
worksheet.putValue("B1", "Value");
const headerStyle = new Style();
headerStyle.setBold(true);
worksheet.getCell2("A1").setStyle(headerStyle);
worksheet.getCell2("B1").setStyle(headerStyle);
const validation = new DataValidation();
validation.type = "list";
validation.formula1 = '"Active,Inactive,Pending"';
worksheet.addDataValidation(validation, "A2:A20");
worksheet.setAutoFilter("A1:B20");
await workbook.save("managed.xlsx");
Open Source et licences
Aspose.Cells FOSS pour TypeScript est publié sous licence MIT. Le code source est disponible sur GitHub. L’utilisation commerciale est autorisée selon les termes de la licence MIT.
