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