كيفية تخصيص واجهة مستخدم CODE وإخفاء أشرطة أدوات محددة

باختصار: في برنامج CODE، يمكنك تغيير نمط شريط الأدوات العام من خلال إعداد العرض المضغوط أو ذي علامات التبويب. لإخفاء علامة تبويب دفتر ملاحظات واحدة أو أمر واحد، فإن الطريقة المعتمدة هي واجهة برمجة تطبيقات PostMessage الخاصة بمضيف WOPI؛ إذ لا تُزيل قوائم العرض العادية الأوامر الفردية بشكل دائم لجميع المستخدمين. يمكن للمسؤولين تعيين وضع الواجهة الافتراضي للخادم، بينما يمكن للمضيفين الذين يدمجون برنامج CODE إرسال رسائل إخفاء أو إظهار على مستوى الجلسة.

اختر الطريقة التي تناسب صلاحياتك. إذا كنت ترغب فقط في مساحة أكبر للمستند، فقم بطي شريط الأدوات أو التبديل إلى العرض المضغوط. إذا كان تكامل WOPI الخاص بك يتطلب حذف علامة تبويب "المساعدة" أو أمر تنسيق، فأرسل رسالة PostMessage المناسبة بعد أن يصبح المحرر جاهزًا. إذا كان هدفك هو منع إجراء معين مثل الطباعة أو التنزيل أو التحرير، فاستخدم أيضًا إمكانية أو إذن WOPI ذي الصلة؛ إخفاء زر ما يغير طريقة العرض، وليس صلاحيات الوصول.

اختر التخصيص المناسب

يشير دليل SDK ذي الصلة Hide_NotebookTabإلى توفره بدءًا من الإصدار 24.04.11.1 وبدءًا Hide_Commandمن الإصدار 24.04.11.2. قد تختلف حزم إصدار CODE وإصدارات التكامل، لذا تحقق من إصدار الخادم الذي تستخدمه فعليًا قبل الاعتماد على رسالة API.

قم بتغيير الإعداد الافتراضي بين العرض المضغوط والعرض ذي علامات التبويب

يستخدم العرض المُصغّر قائمة وشريط أدوات أصغر. يجمع العرض ذو علامات التبويب عناصر التحكم في علامات تبويب شريط دفتر الملاحظات. إعداد الخادم هو user_interface.mode، مع القيم المدعومة compactو tabbed. تم إيقاف استخدام التسميات القديمة مثل classicو notebookbarلصالح هذه الأسماء.

للحصول على إعدادات افتراضية يتحكم بها المسؤول، قم بتعديل <mode>الإدخال الموجود داخل <user_interface>قسم coolwsd.xml:

<user_interface>
  <mode type="string" desc="Controls the user interface style. The 'default' means: Take the value from ui_defaults, or decide for one of compact or tabbed (default|compact|tabbed)" default="default">tabbed</mode>
</user_interface>

استخدم compactبدلاً من ذلك tabbedللقائمة المختصرة. في ملف التكوين الفعلي، غيّر إدخال الوضع الحالي بدلاً من إضافة إدخال ثانٍ. يعتمد مسار التكوين الدقيق وإجراء إعادة التشغيل على ما إذا كان CODE مثبتًا كحزمة أو حاوية أو من خلال منصة أخرى. اتبع طريقة التكوين الخاصة بهذا التثبيت، وأعد تشغيل الخدمة أو أعد تحميلها حسب الحاجة، وافتح جلسة مستند جديدة لتأكيد الإعدادات الافتراضية.

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

قم بطي شريط الأدوات دون إزالة الأوامر

عندما يكون الهدف هو زيادة مساحة المستند، يكفي عادةً طي شريط دفتر الملاحظات ذي علامات التبويب. تُخفي رسالة SDK Collapse_Notebookbarأزرار شريط دفتر الملاحظات، بينما تبقى أسماء علامات التبويب متاحة ليتمكن المستخدمون من توسيع عناصر التحكم مرة أخرى. كما تُخفي الرسالة نفسها شريط الأزرار في العرض المُصغّر. هذا تغيير عرض قابل للعكس، وليس وسيلة لتعطيل ميزات التحرير.

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

إخفاء علامة تبويب أو أمر واحد في تكامل WOPI

يتطلب إخفاء المحتوى لكل جلسة تطبيقًا مضيفًا يُضمّن الكود في إطار iframe ويستطيع إرسال الرسائل إليه. هذا ليس إعدادًا عامًا يُمكن لصقه في ملف الإعدادات coolwsd.xml. تستخدم واجهة برمجة تطبيقات PostMessage رسائل تحتوي على مُعرّف MessageId، وطابع زمني، ومعلومات اختيارية Values. يجب على مُضيف WOPI إكمال عملية التحقق من الجاهزية قبل إرسال أوامر المُحرر. قم بتهيئة WOPI PostMessageOriginلصفحة الاستضافة واستخدم مُعرّف إطار iframe الخاص بالكود نفسه كهدف لرسالة المتصفح؛ لا تستخدم مُعرّف هدف عام.

بعد أن يستقبل المضيف App_LoadingStatusإشارة الجاهزية المناسبة ويرسلها Host_PostmessageReady، يمكنه إرسال رسالة إخفاء. على سبيل المثال، تُخفي الاستدعاءات التالية علامة تبويب "المساعدة" وأمر التسطير لجلسة المحرر المفتوحة:

const frame = document.getElementById("collaboraFrame");
const collaboraOrigin = "https://office.example.com";

function sendToCollabora(MessageId, Values = {}) {
  frame.contentWindow.postMessage({
    MessageId,
    SendTime: Date.now(),
    Values
  }, collaboraOrigin);
}

// Call after the WOPI PostMessage readiness exchange.
sendToCollabora("Hide_NotebookTab", { id: "Help" });
sendToCollabora("Hide_Command", { id: ".uno:Underline" });

استبدل office.example.comهذا بمصدر إطار iframe الخاص بك في CODE. يوضح المثال شكل الرسالة؛ قم بتوصيلها بدورة حياة إطار iframe الحقيقي للمضيف، وتحقق من مصدر الرسائل الواردة قبل الرد. تشير وثائق CODE إلى أنه Host_PostmessageReadyقد يتم تجاهل رسائل المضيف المرسلة مسبقًا.

أي رسالة يجب عليك استخدامها؟

• Hide_NotebookTabاستخدمه لعلامة تبويب كاملة في عرض علامات التبويب. وهو idمُعرّف علامة التبويب، مثل Help. Show_NotebookTabيُعكس التغيير. تبقى علامة التبويب مخفية طوال الجلسة حتى وصول رسالة إظهار.
• Hide_Commandاستخدم هذا الخيار عندما تريد إخفاء الأمر من القائمة وشريط الأدوات والقوائم السياقية. مثال على ذلك: .uno:Underline. . Show_Commandلعكسه. استخدم هذا الخيار فقط عندما يكون الهدف هو إزالة الأمر من جميع هذه العناصر.
• Hide_Buttonاستخدم هذه الخاصية عندما تريد إخفاء زر واحد بدلاً من إخفاء جميع عناصر واجهة المستخدم الخاصة بالأمر. معرّفها هو معرّف زر شريط الأدوات، وليس بالضرورة اسم أمر UNO. تشير وثائق Collabora إلى أن هذه المعرّفات عادةً ما تظل ثابتة، ولكن لا يُضمن ذلك؛ لذا تأكد من مطابقتها مع الكود المصدري الخاص بإصدارك وشكل جهازك.
• Hide_Menubarهذا الخيار يُخفي شريط القوائم بالكامل. وهو ليس خيارًا خاصًا بكل أمر على حدة، ولا ينبغي الخلط بينه وبين إخفاء علامة تبويب في شريط الملاحظات.

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

تأكد من أن التغيير يناسب حالة استخدامك

افتح مستندًا تجريبيًا باستخدام نفس المتصفح ونوع المستند والأذونات وإصدار البرنامج الذي يستخدمه المستخدمون. تأكد من الوضع المُختار، وتحقق من إخفاء علامة التبويب أو الأمر المطلوب فقط، واختبر ظهور رسالة التنبيه أو توسيع شريط الأدوات. كرر هذه الخطوات لبرامج Writer وCalc وImpress إذا كان التكامل يخدمها جميعًا؛ إذ قد لا تكون الأوامر المتاحة ومعرّفات شريط الأدوات متطابقة بين الوحدات.

إذا استمر ظهور عنصر تحكم مخفي، فتحقق من المضيف المُرسِل Host_PostmessageReady، ومن صحة مصدر WOPI PostMessageOriginو iframe المستهدف، ومن استخدام الرسالة للمعرّف والتهجئة المتوقعين. تحقق أيضًا من إصدار الخادم مقارنةً بالإصدار الأساسي للميزة الموثّق. لا يؤدي إخفاء العنصر المرئي بنجاح إلى إزالة الأمر من محرك المستندات الأساسي أو فرض قيود أمنية. استخدم أذونات WOPI وسياسة الواجهة الخلفية للتحكم في الوصول.

المراجع الرسمية

• دليل Collabora Online SDK، الإصدار 24.04: التكوين وواجهة برمجة تطبيقات PostMessage
• وثائق واجهة برمجة تطبيقات PostMessage الخاصة بمجموعة تطوير البرمجيات Collabora Online
• ملاحظات إصدار CODE 26.04
• ملاحظات إصدار CODE 21.11: تبديل العرض المضغوط والعرض ذي علامات التبويب