Introducere
Aspose.Cells FOSS pentru TypeScript oferă un set cuprinzător de funcționalități de gestionare a foilor de calcul, dincolo de citirea și scrierea de bază a celulelor. Dezvoltatorii pot aplica stiluri detaliate, pot configura reguli de validare a datelor, pot configura auto-filtre, pot adăuga formatare condițională, pot construi grafice, pot insera forme și pot proteja registrele de lucru – toate din cod TypeScript fără dependență de Microsoft Office.
Acest articol parcurge principalele capacităţi de gestionare a foilor de calcul disponibile în bibliotecă, cu exemple de cod funcţionale pentru fiecare domeniu de funcţionalitate.
Caracteristici principale
Validare date
Adăugați reguli de validare la intervalele de celule utilizând clasa DataValidation. Tipurile de validare acceptate includ listă, interval numeric și formule personalizate. Aplicați validarea la orice interval cu 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");
Filtru automat
Activați anteturile de auto-filtru pe un interval de date cu worksheet.setAutoFilter(). Aceasta adaugă controale de filtrare prin listă derulantă la anteturile de coloană în fișierul XLSX de ieșire. Eliminați filtrele cu 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");
Formatare condițională
Aplicați reguli vizuale la intervale de celule utilizând ConditionalFormatCollection. Biblioteca suportă ColorScaleRule, DataBarRule și IconSetRule pentru evidențierea celulelor în funcție de valorile lor.
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");
Hiperlinkuri și comentarii
Adăugați hyperlinkuri la celule cu cell.setHyperlink() care susțin URL-uri, adrese de e‑mail și referințe interne la foi. Adăugați comentarii cu worksheet.addComment() utilizând obiecte 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");
Protecție a registrului și a celulei
Protejați întregi registre de lucru cu o parolă utilizând workbook.protect(). Blocați celulele individuale cu style.setLocked(true) și controlați vizibilitatea formulelor cu 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");
Dimensionarea coloanelor și a rândurilor
Setați lățimile coloanelor cu worksheet.setColumnWidth() și înălțimile rândurilor cu worksheet.setRowHeight(). Ascundeți rândurile cu worksheet.setRowHidden(). Aceste setări persistă în fișierul XLSX salvat.
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");
Pornire rapidă
Instalați cu npm:
npm install @aspose/cells@1.0.0
Creează un registru de lucru stilizat cu validare și filtrare automată:
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 și Licențiere
Aspose.Cells FOSS pentru TypeScript este lansat sub licența MIT. Codul sursă este disponibil pe GitHub. Utilizarea comercială este permisă în conformitate cu termenii licenței MIT.
