Введение

Aspose.Cells FOSS для 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");

Быстрый старт

Соберите пакет из исходного кода:

git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-TypeScript.git
cd Aspose.Cells-FOSS-for-TypeScript
npm install
npm run build

Создайте рабочую книгу, запишите данные, примените стили и сохраните:

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");

Поддерживаемые форматы

ФорматРасширениеЧитатьЗаписать
XLSX.xlsx✓✓
CSV.csv—✓
JSON.json—✓
Markdown.md—✓
HTML.html✓✓

Открытый исходный код и лицензирование

Aspose.Cells FOSS для TypeScript выпущен под лицензией MIT. Исходный код размещён на GitHub и принимает сообщения об ошибках и запросы на включение изменений. Коммерческое использование разрешено на условиях лицензии MIT.


Начало работы

Связанные ресурсы