مقدمه

Aspose.Cells FOSS برای TypeScript یک کتابخانهٔ رایگان و متن باز است که به توسعه‌دهندگان امکان ایجاد، خواندن، ویرایش و استخراج صفحات‌گستردهٔ Excel را مستقیماً از برنامه‌های TypeScript می‌دهد. این کتابخانه تحت مجوز MIT است و هیچ وابستگی‌ای به Microsoft Office یا هر زمان‌اجرای بومی ندارد – به‌صورت یکسان بر روی 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");

قلم و استایل پر کردن

قالب bold، italic، اندازه قلم، نام قلم و رنگ قلم را با استفاده از کلاس 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

یک workbook ایجاد کنید، داده‌ها را بنویسید، استایل اعمال کنید و ذخیره کنید:

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 میزبانی می‌شود و گزارش‌های باگ و درخواست‌های pull را می‌پذیرد. استفاده تجاری تحت شرایط مجوز MIT مجاز است.


شروع کار

منابع مرتبط