Uvod
Aspose.Cells FOSS for TypeScript pruža sveobuhvatan skup značajki upravljanja proračunskim tablicama, nadilazeći osnovno čitanje/pisanje ćelija. Programeri mogu primijeniti detaljno oblikovanje, postaviti pravila provjere podataka, konfigurirati automatske filtere, dodati uvjetno formatiranje, izraditi grafikone, umetnuti oblike i zaštititi radne knjige — sve iz TypeScript koda bez ovisnosti o Microsoft Officeu.
Ovaj post prolazi kroz ključne mogućnosti upravljanja proračunskim tablicama dostupne u biblioteci, s radnim primjerima koda za svako područje funkcionalnosti.
Ključne značajke
Validacija podataka
Dodajte pravila provjere valjanosti na raspon ćelija koristeći klasu DataValidation. Podržane vrste provjere uključuju popis, raspon brojeva i prilagođene formule. Primijenite provjeru na bilo koji raspon s 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");
Automatski filter
Omogući zaglavlja automatskog filtra na rasponu podataka pomoću worksheet.setAutoFilter(). Ovo dodaje kontrole padajućeg filtra na zaglavlja stupaca u izlaznoj XLSX datoteci. Ukloni filtere pomoću 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");
Uslovno formatiranje
Primijenite vizualna pravila na raspon ćelija koristeći ConditionalFormatCollection. Biblioteka podržava ColorScaleRule, DataBarRule i IconSetRule za isticanje ćelija na temelju njihovih vrijednosti.
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");
Hiperveze i komentari
Priložite hiperveze na ćelije s cell.setHyperlink() podržavajući URL‑ove, adrese e‑pošte i interne reference na listu. Dodajte komentare s worksheet.addComment() koristeći Comment objekte.
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");
Zaštita radne knjige i ćelija
Zaštitite cijele radne knjige lozinkom koristeći workbook.protect(). Zaključajte pojedinačne ćelije pomoću style.setLocked(true) i kontrolirajte vidljivost formula pomoću 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");
Veličina stupca i retka
Postavite širine stupaca pomoću worksheet.setColumnWidth() i visine redaka pomoću worksheet.setRowHeight(). Sakrijte redove pomoću worksheet.setRowHidden(). Ove postavke ostaju u spremljenoj XLSX datoteci.
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");
Brzi početak
Instalirajte s npm-om:
npm install @aspose/cells@1.0.0
Izradite stiliziranu radnu knjigu s validacijom i automatskim filtriranjem:
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 licenciranje
Aspose.Cells FOSS za TypeScript objavljen je pod MIT licencom. Izvorni kod je dostupan na GitHub. Komercijalna upotreba je dopuštena prema uvjetima MIT licence.