دليل المطورين إلى واجهات برمجة التطبيقات (APIs) للأنماط والألوان في ONLYOFFICE

غالبًا ما يعني تطوير اضافات ONLYOFFICE تحسين كيفية تفاعل المستخدمين مع المستندات، سواء عن طريق إضافة أدوات تمييز، أو منظفات تنسيق، أو عناصر واجهة مستخدم ذات سمات.

لمساعدتكم على العمل بكفاءة أكبر، قمنا بتجميع أساليب واجهة برمجة التطبيقات (API) الرئيسية للأنماط والألوان التي تتيح للمطورين التحكم بسهولة في شكل ومظهر اضافاتهم.

يقدم هذا المقال شروحات واضحة، وأمثلة عملية، ونصائح لتجربة تطوير أسلس.

فهم سياق الأنماط

توفر واجهات برمجة التطبيقات (APIs) لاضافات ONLYOFFICE طرقًا مرنة لتخصيص مظهر المستند من خلال عناصر مثل ApiRange، و ApiParagraph، و ApiTextPr.

تتيح هذه الواجهات للمطورين تعديل سمات الخط، ومحاذاة الفقرة، والألوان، والخصائص المرئية الأخرى مباشرة من البرامج النصية للاضافة.

مثال بسيط لتطبيق أنماط النص:

const oDocument = Api.GetDocument();

const oRange = oDocument.GetRangeBySelect();

const oTextPr = oRange.GetTextPr();

oTextPr.Bold(true);

oTextPr.Italic(true);

oTextPr.SetColor(255, 0, 0); // RGB red

يوضح هذا المقتطف كيف يمكن دمج أنماط متعددة لتحقيق تنسيق ديناميكي.

أساليب الأنماط والألوان شائعة الاستخدام

عند تطوير اضافات ONLYOFFICE التي تعمل مع أنماط المستندات مثل أدوات التمييز، أو منظفات التنسيق، أو عناصر واجهة المستخدم المستندة إلى السمات، غالبًا ما يحتاج المطورون إلى أساليب واضحة وجاهزة للاستخدام للتعامل مع الألوان والخطوط وسمات النص.

لتبسيط هذه العملية، قمنا بجمع أكثر واجهات برمجة التطبيقات (APIs) للأنماط والألوان عملية هنا، جنبًا إلى جنب مع النصائح والأمثلة للتكامل السلس.

لتطبيق الأنماط على الفقرات، يمكنكم استخدام أساليب مماثلة عبر واجهة ApiParagraph:

const oParagraph = oRange.GetParagraph(0);

oParagraph.SetBackColor(230, 230, 230); // Light gray background

oParagraph.SetAlign("center");

تشكل هذه الأساليب أساس تنسيق النص والفقرات في اضافات ONLYOFFICE. تستخدم خلايا جداول البيانات واجهات برمجة تطبيقات (APIs) متشابهة من حيث المفهوم مثل ApiCell و SetCellColor، باتباع نفس منطق الأنماط.

العمل مع عناصر الألوان

يستخدم ONLYOFFICE تعريفات الألوان المستندة إلى RGB لأساليب الأنماط الخاصة به. إذا كان مشروعكم يستخدم أكواد ألوان HEX (الشائعة في أنظمة التصميم أو سمات العلامات التجارية)، فيمكنكم تحويلها بسهولة باستخدام دالة مساعدة صغيرة:

function hexToRGB(hex) {

const bigint = parseInt(hex.replace("#", ""), 16);

const r = (bigint >> 16) & 255;

const g = (bigint >> 8) & 255;

const b = bigint & 255;

return [r, g, b];

}

// Example use:

const [r, g, b] = hexToRGB("#3498db");

oTextPr.SetColor(r, g, b);
يتيح هذا تكاملاً سلسًا بين موارد التصميم ووظائف الاضافة.

نصائح وحيل لأسلوب موثوق

• أعيدوا تحديد نطاق المستند قبل تطبيق التغييرات لضمان الدقة بعد إجراءات واجهة المستخدم.
• استخدموا استدعاءات دالة منفصلة لكل عملية نمط بدلاً من ربط عدد كبير جدًا من الأساليب مرة واحدة.
• أجروا دائمًا عمليات التحقق من الصحة، على سبيل المثال، تأكدوا من أن GetRangeBySelect() يُرجع عنصرًا صالحًا.
• ادعموا أوضاع السمة (theme) عن طريق ضبط قيم الألوان ديناميكيًا باستخدام Asc.plugin.getTheme().

تساعد هذه التعديلات الصغيرة على إنشاء سلوك اضافة أكثر استقرارًا وتناسقًا مع السمة.

خاتمة

تحافظ واجهات برمجة التطبيقات (APIs) للأنماط في ONLYOFFICE على نهج متسق عبر مختلف المحررات، سواء كنتم تعملون مع المستندات أو العروض التقديمية أو جداول البيانات.

من خلال إعادة استخدام نفس المفاهيم (تطبيق الألوان، تعديلات الخط، محاذاة الفقرة)، يمكن للمطورين تكييف أكوادهم عبر المحررات مع الحفاظ على توحيد منطق الأنماط.

من خلال جمع هذه المعلومات في مكان واحد، نهدف إلى جعل تطوير الاضافات أسرع وأسلس وأكثر بديهية لكل من يبني باستخدام ONLYOFFICE.

إذا كان لديكم أي أسئلة أو اقتراحات، فلا تترددوا في التواصل معنا. معًا يمكننا مواصلة تحسين وثائق ONLYOFFICE.