1. محصولات
  2.   Aspose.Cells
  3.   Aspose.Cells FOSS for TypeScript

Aspose.Cells FOSS برای TypeScript

ایجاد، ویرایش و استخراج صفحات‌گسترده Excel از TypeScript – رایگان و متن‌باز، بدون وابستگی به Microsoft Office.

Aspose.Cells FOSS for TypeScript Aspose.Cells FOSS
for TypeScript

مستندات GitHub

کتابخانهٔ منبع باز TypeScript برای صفحات‌گستردهٔ Excel

Aspose.Cells FOSS برای TypeScript یک کتابخانه رایگان و متن‌باز برای کار با فایل‌های صفحه‌گسترده در برنامه‌های TypeScript است. آن را با npm install @aspose/cells@1.0.0 نصب کنید و شروع به ایجاد کتاب‌کارها، خواندن سلول‌ها، اعمال سبک‌ها، ساخت نمودارها و خروجی به XLSX، CSV، Markdown، JSON یا HTML کنید — همه اینها بدون نیاز به Microsoft Excel یا هر وابستگی Office.

کتابخانه یک API تمیز ارائه می‌دهد که دور Workbook، Worksheet، Cell و Style ساخته شده است – اشیاء آشنایی که هر توسعه‌دهندهٔ صفحه‌گسترده می‌داند. سلول‌ها را با استفاده از putValue() بخوانید و بنویسید، آنها را با اشیاء Style، Font و Fill استایل دهید، نمودارها را از طریق ChartCollection اضافه کنید، و اعتبارسنجی داده، فیلترهای خودکار، نظرات و هایپرلینک‌ها را در هر برگه کاری تنظیم کنید.

خواندن و نوشتن فایل‌های Excel

  • XLSX round-trip: بارگذاری کتاب‌های کاری با Workbook.load() و ذخیره با workbook.save() به‌طوری که مقادیر سلول‌ها، فرمول‌ها و سبک‌ها حفظ شوند.
  • دسترسی به سلول: مقادیر را با worksheet.putValue() و worksheet.getCell() بر اساس اندیس ردیف/ستون یا مرجع سلول بخوانید و بنویسید.
  • فرمول‌ها: رشته‌های فرمول را از طریق cell.setFormula() بنویسید – به‌صورت دقیق در XLSX ذخیره می‌شوند و هنگام باز شدن توسط Excel یا LibreOffice ارزیابی می‌شوند.
  • چندین برگه کاری: ایجاد، تغییر نام، جابجایی و حذف برگه‌های کاری با روش‌های WorksheetCollection شامل addWorksheet()، removeWorksheet() و moveWorksheet().

جایی که Aspose.Cells FOSS می‌تواند استفاده شود

  • Data pipelines: نتایج پرس‌و‌جوی پایگاه‌داده را به‌صورت مستقیم به XLSX یا CSV صادر کنید با استفاده از workbook.toCsv().
  • تولید گزارش: گزارش‌های Excel با سبک و برند سفارشی را بدون نصب Office بسازید.
  • مستندات: تبدیل صفحات گسترده به مارک‌داون از طریق workbook.toMarkdown().
  • ETL workflows: خواندن شیت‌های ورودی، تبدیل داده‌ها، و نوشتن کتاب‌کارهای خروجی.
  • CI/CD automation: ایجاد صفحات‌گسترده نتایج تست داخل کانتینرهای Docker.

استایل‌دهی، نمودارها و اشکال

  • فونت و پر کردن: با استفاده از Style با setBold()، setItalic()، setFontSize() و setFontColor()، بولد، ایتالیک، اندازهٔ فونت و رنگ‌ها را اعمال کنید.
  • قالب‌های عددی: با استفاده از numFmtId در Style، قالب تاریخ، ارز و قالب عددی سفارشی را برای هر سلول تنظیم کنید.
  • نمودارها: نمودارهای میله‌ای، خطی، دایره‌ای، مساحتی و پراکنده را با ChartCollection بسازید و داده‌های نمودار را از طریق ChartRenderer رندر کنید.
  • Shapes: افزودن اشکال برداری به برگه‌ها با addShape() که مستطیل‌ها، بیضی‌ها، پیکان‌ها، اتصال‌دهنده‌ها و موارد دیگر را از طریق سلسله‌مراتب ShapeInfo پشتیبانی می‌کند.

صادرات و حفاظت

  • صادرات چندفرمت: ذخیره به XLSX، CSV، JSON، Markdown و HTML با استفاده از workbook.save() یا روش‌های اختصاصی مانند toJson()، toCsv()، toMarkdown() و toHtml().
  • HTML واردات و صادرات: بارگذاری جداول HTML با HtmlReader و خروجی‌گیری کتاب‌های کاری قالب‌دار با HtmlExporter.
  • حفاظت از دفتر کار: با استفاده از workbook.protect(true, "password")، دفاتر کار را با یک رمز عبور محافظت کنید.
  • محافظت از سلول: قفل‌گذاری سلول‌های جداگانه با style.setLocked(true) و کنترل نمایش فرمول با style.setHidden().

اعتبارسنجی داده و فیلتر کردن

  • اعتبارسنجی داده: قواعد اعتبارسنجی فهرست، عدد و سفارشی را به بازه‌های سلولی با DataValidation و worksheet.addDataValidation() اضافه کنید.
  • Auto-filter: تنظیم سرستون‌های قابل فیلتر با worksheet.setAutoFilter() و حذف فیلترها با removeAutoFilter().
  • قالب‌بندی شرطی: از طریق ConditionalFormatCollection با ColorScaleRule، DataBarRule و IconSetRule مقیاس‌های رنگی، نوارهای داده و مجموعه‌های نماد را اعمال کنید.
  • نظرات: نظرات سلول را با اشیای Comment از طریق worksheet.addComment() پیوست کنید.

تجربه توسعه‌دهنده

Aspose.Cells FOSS برای TypeScript با یک فرمان npm install @aspose/cells@1.0.0 قابل نصب است. هیچ کتابخانه بومی Office یا بسته سیستمی برای نصب وجود ندارد. این کتابخانه بر روی هر محیط Node.js با پشتیبانی TypeScript 5+ اجرا می‌شود.

API شامل Workbook، Worksheet، Cell، Style، Font، Fill، Chart، DataValidation، AutoFilter، Comment، Hyperlink و Shape – اشیای اصلی برای خودکارسازی واقعی صفحات گسترده. کد منبع دارای مجوز MIT است، در GitHub میزبانی می‌شود و گزارش‌های باگ و pull requests را می‌پذیرد.

نوشتن مقادیر و فرمول‌های سلول

یک کتاب‌کار ایجاد کنید، انواع مختلف مقادیر را در سلول‌ها بنویسید، و فرمول‌هایی تنظیم کنید که اکسل هنگام باز شدن آن‌ها را ارزیابی می‌کند.

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("output.xlsx");

اعمال استایل فونت

نام قلم، اندازه، ضخیم، ایتالیک و رنگ را در یک سلول با استفاده از کلاس Style تنظیم کنید.

const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setItalic(true);
style.setFontColor("FF0000");
const cell = worksheet.getCell2("A1");
cell.putValue("Styled Text");
cell.setStyle(style);
await workbook.save("styled.xlsx");

راه‌اندازی فیلتر خودکار

یک بازه داده را پر کنید و سرصفحه‌های فیلتر خودکار را برای فیلتر کردن تعاملی ستون‌ها در اکسل فعال کنید.

const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Name");
worksheet.putValue("B1", "Age");
worksheet.putValue("C1", "City");
worksheet.putValue("A2", "Alice");
worksheet.putValue("B2", "25");
worksheet.putValue("C2", "New York");
worksheet.putValue("A3", "Bob");
worksheet.putValue("B3", "30");
worksheet.putValue("C3", "London");
worksheet.setAutoFilter("A1:C4");
await workbook.save("filtered.xlsx");

سوالات متداول

Aspose.Cells FOSS - FOSS Aspose.Cells برای TypeScript چیست؟

این یک کتابخانهٔ رایگان و دارای مجوز MIT برای TypeScript است که برای ایجاد، خواندن، اصلاح و استخراج صفحات‌گستردهٔ Excel بدون نیاز به Microsoft Office استفاده می‌شود.

کدام فرمت‌های فایل پشتیبانی می‌شوند؟

.xlsx برای خواندن/نوشتن. فرمت‌های فقط-صادر شامل CSV، JSON، Markdown و HTML هستند. HTML نیز می‌تواند از طریق HtmlReader وارد شود.

آیا به Microsoft Excel یا Office نیاز دارد؟

خیر. Aspose.Cells FOSS یک کتابخانهٔ خالص TypeScript است که هیچ وابستگی به Microsoft Office، COM automation یا هر زمان اجرا مالکیتی ندارد.

چگونه آن را نصب کنم؟

اجرای npm install @aspose/cells@1.0.0. هیچ بستهٔ سیستمی اضافی یا افزونهٔ بومی مورد نیاز نیست.

آیا می‌توانم استایل سلول را اعمال کنم؟

بله. از کلاس Style با متدهایی مانند setBold()، setItalic()، setFontSize()، setFontName() و setFontColor() برای استایل‌دهی به سلول‌های جداگانه استفاده کنید.

آیا حفاظت از کتاب کار پشتیبانی می‌شود؟

بله. با فراخوانی workbook.protect(true, "password") می‌توانید یک کتاب‌کار را با رمز عبور محافظت کنید. سلول‌های جداگانه می‌توانند با style.setLocked(true) قفل شوند.

  

منابع پشتیبانی و آموزش

 فارسی