Quickstart
Цей посібник проходить через основний 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");