Быстрый старт
Это руководство проходит по основному Aspose.Cells FOSS для TypeScript рабочему процессу: создание рабочей книги с нуля, загрузка существующего файла XLSX, стилизация ячеек и экспорт данных в другие форматы. Каждый раздел ниже представляет собой автономный пример, который вы можете скопировать в проект Node.js после сборки библиотеки из исходного кода.
Создать рабочую книгу
Создайте новый Workbook, запишите типизированные значения (строки и числа) в ячейки с помощью worksheet.putValue() и сохраните результат в файл XLSX:
import { Workbook } 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);
await workbook.save("report.xlsx");Загрузить существующую рабочую книгу
Откройте существующий файл XLSX с помощью Workbook.load(), затем считайте значения ячеек обратно с помощью worksheet.getCell(). Это типичная точка входа для чтения данных таблицы, созданных другим инструментом:
import { Workbook } from "excel-cells";
const workbook = await Workbook.load("report.xlsx");
const worksheet = workbook.worksheets[0]!;
const product = worksheet.getCell(0, 0)?.value;
const revenue = worksheet.getCell(0, 1)?.value;
console.log(`${product}: ${revenue}`);Применить стили
Создайте объект Style и примените настройки шрифта — имя, размер, полужирный и цвет — перед тем как назначить его ячейке с помощью cell.setStyle(). Стили являются независимыми объектами, поэтому один и тот же экземпляр Style можно переиспользовать в разных ячейках:
import { Workbook, Style } from "excel-cells";
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");Экспорт в несколько форматов
Вызовите workbook.save() с другим расширением файла, чтобы экспортировать те же данные в CSV, JSON, Markdown или HTML – не требуется отдельный шаг конвертации:
import { Workbook } from "excel-cells";
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.xlsx");
await workbook.save("data.csv");
await workbook.save("data.json");
await workbook.save("data.md");