Wprowadzenie
Aspose.Cells FOSS dla TypeScript jest darmową, otwarto-źródłową biblioteką, która pozwala programistom tworzyć, odczytywać, modyfikować i eksportować arkusze Excel bezpośrednio z aplikacji TypeScript. Biblioteka jest 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 zapewnia czysty API oparty na klasach 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 autofiltrowanie, 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, generatorów raportów oraz narzędzi do eksportu danych bez żadnych zależności od Office.
Kluczowe funkcje
Odczyt i zapis plików XLSX
Wczytaj istniejące skoroszyty przy użyciu Workbook.load() i zapisz je za pomocą workbook.save(). Wartości komórek, formuły i style przechodzą przez XLSX w obie strony 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
Zapisuj liczby całkowite, liczby dziesiętne i ciągi znaków za pomocą worksheet.putValue(). Ustawiaj 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 przy użyciu 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
Zbuduj pakiet ze źródeł:
git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-TypeScript.git
cd Aspose.Cells-FOSS-for-TypeScript
npm install
npm run buildUtwórz skoroszyt, zapisz dane, zastosuj formatowanie i zapisz:
import { Workbook, Style } from "excel-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 dla TypeScript jest wydany 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.