Wprowadzenie
Aspose.Cells FOSS for TypeScript to darmowa, otwarto‑źródłowa biblioteka, która pozwala programistom tworzyć, odczytywać, modyfikować i eksportować arkusze Excel bezpośrednio z aplikacji TypeScript. Biblioteka jest licencjonowana na licencji MIT i nie ma zależności od Microsoft Office ani żadnego natywnego środowiska uruchomieniowego — działa identycznie na Windows, Linux i macOS.
Biblioteka udostępnia czyste API zbudowane wokół klas Workbook, Worksheet, Cell i Style. Programiści mogą zapisywać wartości komórek, ustawiać formuły, stosować stylizację czcionek i wypełnień, dodawać wykresy i kształty, konfigurować walidację danych oraz automatyczne filtry, a także eksportować do wielu formatów, w tym XLSX, CSV, JSON, Markdown i HTML.
Zainstaluj jednym poleceniem i rozpocznij budowanie potoków automatyzacji arkuszy kalkulacyjnych, generatorów raportów oraz narzędzi eksportu danych bez żadnych zależności od Office.
Kluczowe funkcje
Odczyt i zapis plików XLSX
Załaduj istniejące skoroszyty przy użyciu Workbook.load() i zapisz przy użyciu workbook.save(). Wartości komórek, formuły i style przechodzą przez XLSX bez utraty. Klasa WorksheetCollection obsługuje tworzenie, usuwanie i zmienianie kolejności arkuszy.
const workbook = await Workbook.load("input.xlsx");
const worksheet = workbook.worksheets[0]!;
console.log("A1:", worksheet.getCell(0, 0)?.value);
worksheet.putValue("B1", "Updated");
await workbook.save("output.xlsx");
Wartości komórek i formuły
Napisz liczby całkowite, liczby dziesiętne i ciągi znaków przy użyciu worksheet.putValue(). Ustaw formuły przy użyciu cell.setFormula() – ciąg formuły jest przechowywany dosłownie w pliku XLSX i oceniany przez Excel lub LibreOffice po otwarciu.
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", 42);
worksheet.putValue("A2", 3.14159);
worksheet.putValue("A3", "Hello World");
const cellA4 = worksheet.getCell2("A4");
cellA4.setFormula("=SUM(A1:A2)");
await workbook.save("formulas.xlsx");
Stylizacja czcionki i wypełnienia
Zastosuj pogrubienie, kursywę, rozmiar czcionki, nazwę czcionki i kolor czcionki przy użyciu klasy Style. Każda komórka może mieć własny niezależny styl zastosowany za pomocą cell.setStyle().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setFontColor("FF0000");
const cell = worksheet.getCell2("A1");
cell.putValue("Styled Text");
cell.setStyle(style);
await workbook.save("styled.xlsx");
Eksport wieloformatowy
Eksportuj skoroszyty do CSV, JSON, Markdown i HTML, używając dedykowanych metod w Workbook: toCsv(), toJson(), toMarkdown() i toHtml(). Alternatywnie, przekaż ścieżkę pliku z żądanym rozszerzeniem do workbook.save().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Name");
worksheet.putValue("B1", "Age");
worksheet.putValue("A2", "Alice");
worksheet.putValue("B2", 25);
await workbook.save("data.csv");
await workbook.save("data.json");
await workbook.save("data.md");
Szybki start
Zainstaluj pakiet przy użyciu npm:
npm install @aspose/cells@1.0.0
Utwórz skoroszyt, wpisz dane, zastosuj stylizację i zapisz:
import { Workbook, Style } from "@aspose/cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Product");
worksheet.putValue("B1", "Revenue");
worksheet.putValue("A2", "Widget");
worksheet.putValue("B2", 42000);
worksheet.putValue("A3", "Gadget");
worksheet.putValue("B3", 31500);
const headerStyle = new Style();
headerStyle.setBold(true);
headerStyle.setFontSize(12);
worksheet.getCell2("A1").setStyle(headerStyle);
worksheet.getCell2("B1").setStyle(headerStyle);
worksheet.setAutoFilter("A1:B3");
await workbook.save("report.xlsx");
Obsługiwane formaty
| Format | Rozszerzenie | Odczyt | Zapis |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
| HTML | .html | ✓ | ✓ |
Open Source i licencjonowanie
Aspose.Cells FOSS for TypeScript jest udostępniony na licencji MIT. Kod źródłowy jest hostowany na GitHub i przyjmuje zgłoszenia błędów oraz pull requesty. Komercyjne użycie jest dozwolone na warunkach licencji MIT.
