مقدمة

Aspose.Cells FOSS for TypeScript هي مكتبة مجانية ومفتوحة المصدر تتيح للمطورين إنشاء وقراءة وتعديل وتصدير جداول Excel مباشرةً من تطبيقات TypeScript. المكتبة مرخصة MIT ولا تعتمد على Microsoft Office أو أي بيئة تشغيل أصلية — فهي تعمل بنفس الطريقة على Windows وLinux وmacOS.

توفر المكتبة واجهة برمجة تطبيقات نظيفة مبنية حول 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");

تنسيق الخط والملء

تطبيق الخط العريض، المائل، حجم الخط، اسم الخط، ولون الخط باستخدام الفئة 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 وتقبل تقارير الأخطاء وطلبات السحب. يُسمح بالاستخدام التجاري وفقًا لشروط رخصة MIT.

البدء

الموارد ذات الصلة