Вступ
Aspose.Cells FOSS for TypeScript — це безкоштовна, з відкритим вихідним кодом бібліотека, яка дозволяє розробникам створювати, читати, змінювати та експортувати електронні таблиці Excel безпосередньо з TypeScript‑додатків. Бібліотека має ліцензію MIT і не залежить від Microsoft Office чи будь‑якого рідного runtime – вона працює однаково на Windows, Linux та macOS.
Бібліотека надає чистий API, побудований навколо класів Workbook, Worksheet, Cell та Style. Розробники можуть записувати значення клітинок, встановлювати формули, застосовувати стилі шрифтів і заповнення, додавати діаграми та форми, налаштовувати перевірку даних і автофільтри, а також експортувати у кілька форматів, включаючи XLSX, CSV, JSON, Markdown та HTML.
Встановіть за допомогою однієї команди та почніть створювати конвеєри автоматизації електронних таблиць, генератори звітів та інструменти експорту даних без будь‑якої залежності від Office.
Ключові особливості
Читання та запис файлів XLSX
Завантажуйте існуючі робочі книги за допомогою Workbook.load() і зберігайте за допомогою workbook.save(). Значення клітинок, формули та стилі проходять через XLSX без втрат. Клас WorksheetCollection підтримує створення, видалення та переупорядкування аркушів.
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");
Значення клітинок і формули
Записуйте цілі числа, десяткові числа та рядки за допомогою worksheet.putValue(). Встановлюйте формули за допомогою cell.setFormula() – рядок формули зберігається дослівно у файлі XLSX і обчислюється Excel або LibreOffice під час відкриття.
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");
Стилізація шрифту та заповнення
Застосуйте жирний, курсив, розмір шрифту, назву шрифту та колір шрифту за допомогою класу Style. Кожна клітинка може мати власний незалежний стиль, застосований за допомогою 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");
Багатоформатний експорт
Експортуйте робочі книги у CSV, JSON, Markdown та HTML, використовуючи спеціальні методи на Workbook: toCsv(), toJson(), toMarkdown() та toHtml(). Альтернативно, передайте шлях до файлу з потрібним розширенням у 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");
Швидкий старт
Встановіть пакет за допомогою npm:
npm install @aspose/cells@1.0.0
Створіть робочий зошит, запишіть дані, застосуйте стилізацію та збережіть:
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");
Підтримувані формати
| Формат | Розширення | Читання | Запис |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
| HTML | .html | ✓ | ✓ |
Open Source та ліцензування
Aspose.Cells FOSS для TypeScript випущено під ліцензією MIT. Вихідний код розміщено на GitHub і приймає повідомлення про помилки та запити на злиття. Комерційне використання дозволено згідно з умовами ліцензії MIT.
