Ievads
Aspose.Cells FOSS for TypeScript nodrošina plašu izklājlapu pārvaldības funkciju komplektu, kas pārsniedz pamata šūnu lasīšanu/rakstīšanu. Izstrādātāji var piemērot detalizētu stilizēšanu, izveidot datu validācijas noteikumus, konfigurēt automātiskos filtrus, pievienot nosacīto formatēšanu, veidot diagrammas, ievietot formas un aizsargāt darba grāmatas – viss no TypeScript koda, bez Microsoft Office atkarības.
Šajā rakstā tiek aplūkotas galvenās izklājlapu pārvaldības iespējas, kas pieejamas bibliotēkā, ar funkcionāliem koda piemēriem katrai funkcionalitātes jomai.
Galvenās funkcijas
Datu validācija
Pievienojiet validācijas noteikumus šūnu diapazoniem, izmantojot DataValidation klasi. Atbalstītie validācijas veidi ietver sarakstu, skaitļu diapazonu un pielāgotas formulas. Pielietojiet validāciju jebkuram diapazonam ar 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");
Auto-filtrs
Iespējot automātiskā filtra galvenes datu diapazonā ar worksheet.setAutoFilter(). Tas pievieno nolaižamas filtra vadīklas kolonnas galvenēm izvades XLSX failā. Noņemiet filtrus ar 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");
Kondicionālais formatējums
Lietojiet vizuālos noteikumus šūnu diapazoniem, izmantojot ConditionalFormatCollection. Bibliotēka atbalsta ColorScaleRule, DataBarRule un IconSetRule, lai izceltu šūnas, pamatojoties uz to vērtībām.
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");
Saites un komentāri
Pievienojiet hipersaites šūnām ar cell.setHyperlink(), kas atbalsta URL, e-pasta adreses un iekšējās lapas atsauces. Pievienojiet komentārus ar worksheet.addComment(), izmantojot Comment objektus.
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");
Darblapas un šūnas aizsardzība
Aizsargājiet visus darba grāmatas ar paroli, izmantojot workbook.protect(). Bloķējiet atsevišķas šūnas ar style.setLocked(true) un kontrolējiet formulas redzamību ar 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");
Kolonnas un rindu izmēri
Iestatiet kolonnu platumus ar worksheet.setColumnWidth() un rindu augstumus ar worksheet.setRowHeight(). Paslēpiet rindas ar worksheet.setRowHidden(). Šie iestatījumi saglabājas saglabātajā XLSX failā.
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");
Ātrais sākums
Instalējiet, izmantojot npm:
npm install @aspose/cells@1.0.0
Izveidojiet stilizētu darba grāmatu ar validāciju un automātisko filtru:
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");
Atvērtais kods & licencēšana
Aspose.Cells FOSS for TypeScript ir izlaists zem MIT licences. Avota kods ir pieejams vietnē GitHub. Komerciāla lietošana ir atļauta saskaņā ar MIT licences noteikumiem.
