Giriş
Aspose.Cells FOSS for TypeScript, temel hücre okuma/yazmanın ötesinde kapsamlı bir elektronik tablo yönetimi özellikleri seti sunar. Geliştiriciler ayrıntılı stil uygulayabilir, veri doğrulama kuralları oluşturabilir, otomatik filtreleri yapılandırabilir, koşullu biçimlendirme ekleyebilir, grafikler oluşturabilir, şekiller ekleyebilir ve çalışma kitaplarını koruyabilir – tüm bunlar Microsoft Office bağımlılığı olmadan TypeScript kodundan yapılabilir.
Bu gönderi, kütüphanede mevcut olan temel elektronik tablo yönetimi yeteneklerini, her özellik alanı için çalışan kod örnekleriyle birlikte ele alır.
Temel Özellikler
Veri Doğrulama
DataValidation sınıfını kullanarak hücre aralıklarına doğrulama kuralları ekleyin. Desteklenen doğrulama türleri arasında liste, sayı aralığı ve özel formüller bulunur. worksheet.addDataValidation() ile herhangi bir aralığa doğrulama uygulayın.
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");
Otomatik Filtre
worksheet.setAutoFilter() ile bir veri aralığında otomatik filtre başlıklarını etkinleştirin. Bu, çıktı XLSX dosyasındaki sütun başlıklarına açılır menü filtre kontrolleri ekler. worksheet.removeAutoFilter() ile filtreleri kaldırın.
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");
Koşullu Biçimlendirme
ConditionalFormatCollection kullanarak hücre aralıklarına görsel kurallar uygulayın. Kütüphane, hücreleri değerlerine göre vurgulamak için ColorScaleRule, DataBarRule ve IconSetRule‘i destekler.
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");
Hipermetin Bağlantıları ve Yorumlar
cell.setHyperlink() destekleyen URL’ler, e-posta adresleri ve iç sayfa referanslarıyla hücrelere hiperlink ekleyin. Comment nesnelerini kullanarak worksheet.addComment() ile yorumlar ekleyin.
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");
Çalışma Kitabı ve Hücre Koruması
Tüm çalışma kitaplarını bir şifreyle korumak için workbook.protect() kullanın. Tek tek hücreleri style.setLocked(true) ile kilitleyin ve formül görünürlüğünü style.setHidden() ile kontrol edin.
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");
Sütun ve Satır Boyutlandırma
worksheet.setColumnWidth() ile sütun genişliklerini ve worksheet.setRowHeight() ile satır yüksekliklerini ayarlayın. worksheet.setRowHidden() ile satırları gizleyin. Bu ayarlar kaydedilen XLSX dosyasında kalıcıdır.
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");
Hızlı Başlangıç
npm ile kurun:
npm install @aspose/cells@1.0.0
Doğrulama ve otomatik filtreleme ile stillendirilmiş bir çalışma kitabı oluşturun:
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");
Açık Kaynak ve Lisanslama
Aspose.Cells FOSS for TypeScript MIT lisansı altında yayınlanmıştır. Kaynak kodu GitHub üzerinden erişilebilir. Ticari kullanım MIT lisansı şartları kapsamında izin verilir.
