مقدمه

Aspose.Cells FOSS for TypeScript یک کتابخانهٔ رایگان و متن‌باز است که به توسعه‌دهندگان امکان ایجاد، خواندن، اصلاح و خروجی‌گیری از صفحات گستردهٔ Excel را مستقیماً از برنامه‌های TypeScript می‌دهد. این کتابخانه تحت مجوز MIT است و هیچ وابستگی‌ای به Microsoft Office یا هر زمان‌اجرای بومی ندارد — به‌صورت یکسان بر روی Windows، Linux و macOS اجرا می‌شود.

کتابخانه یک API تمیز ارائه می‌دهد که بر پایه کلاس‌های Workbook، Worksheet، Cell و Style ساخته شده است. توسعه‌دهندگان می‌توانند مقادیر سلول‌ها را بنویسند، فرمول‌ها را تنظیم کنند، استایل فونت و پر کردن را اعمال کنند، نمودارها و اشکال را اضافه کنند، اعتبارسنجی داده‌ها و فیلترهای خودکار را پیکربندی کنند و به فرمت‌های متعددی از جمله XLSX، CSV، JSON، Markdown و HTML صادر کنند.

با یک فرمان نصب کنید و بدون هیچ وابستگی به آفیس، شروع به ساخت خطوط لوله خودکارسازی صفحات گسترده، تولیدکنندگان گزارش و ابزارهای استخراج داده کنید.

ویژگی‌های کلیدی

خواندن و نوشتن فایل‌های 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✓✓

منبع باز و مجوزها

Aspose.Cells FOSS برای TypeScript تحت مجوز MIT منتشر شده است. کد منبع در GitHub میزبانی می‌شود و گزارش‌های باگ و درخواست‌های pull را می‌پذیرد. استفاده تجاری تحت شرایط مجوز MIT مجاز است.

شروع کار

منابع مرتبط