مقدمة

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

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

طبق الخط العريض والمائل وحجم الخط واسم الخط ولون الخط باستخدام الفئة 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

إنشاء دفتر عمل، كتابة البيانات، تطبيق التنسيق، وحفظه:

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


البدء

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