Wprowadzenie
Aspose.Cells FOSS for TypeScript zapewnia kompleksowy zestaw funkcji zarządzania arkuszami kalkulacyjnymi wykraczających poza podstawowe odczytywanie/zapisywanie komórek. Programiści mogą stosować szczegółowe formatowanie, ustawiać reguły walidacji danych, konfigurować automatyczne filtry, dodawać formatowanie warunkowe, tworzyć wykresy, wstawiać kształty i chronić skoroszyty – wszystko z kodu TypeScript bez zależności od Microsoft Office.
Ten wpis przechodzi przez kluczowe możliwości zarządzania arkuszami kalkulacyjnymi dostępne w bibliotece, z działającymi przykładami kodu dla każdego obszaru funkcji.
Kluczowe funkcje
Walidacja danych
Dodaj reguły walidacji do zakresów komórek przy użyciu klasy DataValidation. Obsługiwane typy walidacji obejmują listę, zakres liczb oraz niestandardowe formuły. Zastosuj walidację do dowolnego zakresu przy użyciu 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-filtr
Włącz automatyczne filtry nagłówków w zakresie danych przy użyciu worksheet.setAutoFilter(). Dodaje to kontrolki filtrów rozwijanych do nagłówków kolumn w pliku wyjściowym XLSX. Usuń filtry przy użyciu 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");
Formatowanie warunkowe
Zastosuj reguły wizualne do zakresów komórek przy użyciu ConditionalFormatCollection. Biblioteka obsługuje ColorScaleRule, DataBarRule i IconSetRule do podświetlania komórek w zależności od ich wartości.
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");
Hiperłącza i komentarze
Dołącz hiperłącza do komórek z cell.setHyperlink() obsługującymi adresy URL, adresy e‑mail i odwołania wewnętrzne do arkusza. Dodaj komentarze z worksheet.addComment() przy użyciu obiektów 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");
Ochrona skoroszytu i komórek
Zabezpiecz całe skoroszyty hasłem przy użyciu workbook.protect(). Zablokuj pojedyncze komórki przy użyciu style.setLocked(true) i kontroluj widoczność formuł przy użyciu 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");
Rozmiarowanie kolumn i wierszy
Ustaw szerokości kolumn za pomocą worksheet.setColumnWidth() i wysokości wierszy za pomocą worksheet.setRowHeight(). Ukryj wiersze za pomocą worksheet.setRowHidden(). Te ustawienia są zachowywane w zapisanym pliku XLSX.
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");
Szybki start
Zainstaluj przy pomocy npm:
npm install @aspose/cells@1.0.0
Utwórz stylowany skoroszyt z walidacją i filtrem automatycznym:
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 licencjonowanie
Aspose.Cells FOSS for TypeScript jest udostępniony na licencji MIT. Kod źródłowy jest dostępny na GitHub. Komercyjne użycie jest dozwolone na warunkach licencji MIT.
