مربعات الحوار والأشرطة الجانبية لإضافات المحرّرين

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

بالنسبة إلى معظم إضافات المحرِّرين، تُعدّ نوافذ الحوار ولوحات الشريط الجانبي واجهات المستخدمين الأساسية للإضافة. كلاهما قابل للتخصيص بالكامل باستخدام HTML وCSS القياسية، ويمكنك استخدام نموذج اتصال خادم العميل لبرمجة التطبيقات لتشغيل وظائف برمجة التطبيقات عندما يتفاعل المستخدم مع الشريط الجانبي أو مربع الحوار. يمكن أن تحدد إضافتك أشرطة جانبية ومربعات حوار متعددة، ولكن يمكن أن تعرض الإضافة واحدًا تلو الآخر.

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

مربّعات حوار

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

يمكنك إنشاء مربعات حوار الإضافة بنفس طريقة إنشاء مربعات حوار مخصصة لبرمجة التطبيقات؛ الإجراء التالي الموصى به هو ما يلي:

  1. أنشئ ملف مشروع نص برمجي يحدد بنية HTML لمربع الحوار، وCSS، وسلوك جافا سكريبت من جانب العميل. عند تحديد مربع الحوار، راجع إرشادات الإرشادات لإضافة نمط المحرر.
  2. في الرمز البرمجي للخادم الذي تريد فتح مربع الحوار عليه، يمكنك استدعاء HtmlService.createHtmlOutputFromFile(filename) لإنشاء كائن HtmlOutput يمثل مربع الحوار. بدلاً من ذلك، إذا كنت تستخدم نموذج HTML، يمكنك استدعاء HtmlService.createTemplateFromFile(filename) لإنشاء نموذج ثم HtmlTemplate.evaluate() لتحويله إلى كائن HtmlOutput.
  3. اتصل بـ Ui.showModalDialog(htmlOutput, dialogTitle) لعرض مربع الحوار باستخدام HtmlOutput.

لا تعلِّق مربعات الحوار النص البرمجي من جانب الخادم أثناء فتحها. ويمكن للغة JavaScript من جهة العميل إجراء استدعاءات غير متزامنة من جانب الخادم باستخدام google.script.run() ووظائف المعالجات المرتبطة بها. لمزيد من التفاصيل، راجع التواصل من عميل إلى خادم.

مربعات حوار فتح الملفات

مربعات حوار فتح الملفات هي مربعات حوار مُعَدّة مسبقًا تتيح للمستخدمين اختيار الملفات من Google Drive. يمكنك إضافة مربع حوار لفتح ملف إلى الإضافة دون الحاجة إلى تصميمه، إلا أنه يتطلب بعض التهيئة الإضافية. ويجب أيضًا الوصول إلى إضافة Cloud Platform الإضافية لتفعيل "أداة اختيار واجهة برمجة التطبيقات من Google".

للاطلاع على التفاصيل الكاملة، راجع مربعات حوار فتح الملفات.

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

يمكنك إنشاء الأشرطة الجانبية بنفس طريقة إنشاء الأشرطة الجانبية المخصصة لبرمجة التطبيقات؛ الإجراء التالي الموصى به هو ما يلي:

  1. أنشئ ملف مشروع نص برمجي يحدد بنية HTML بالشريط الجانبي، وCSS، وسلوك جافا سكريبت من جانب العميل. عند تحديد الشريط الجانبي، يُرجى الرجوع إلى إرشادات حول نمط إضافة الوظيفة الإضافية.
  2. في الرمز البرمجي للخادم الذي تريد أن يفتح فيه الشريط الجانبي، يمكنك استدعاء HtmlService.createHtmlOutputFromFile(filename) لإنشاء كائن HtmlOutput يمثّل الشريط الجانبي. بدلاً من ذلك، إذا كنت تستخدم نموذج HTML، يمكنك استدعاء HtmlService.createTemplateFromFile(filename) لإنشاء نموذج ثم HtmlTemplate.evaluate() لتحويله إلى كائن HtmlOutput.

  3. اتصل بـ Ui.showSidebar(htmlOutput) لعرض الشريط الجانبي باستخدام هذا HtmlOutput.

لا تعلّق الأشرطة الجانبية النص البرمجي من جانب الخادم أثناء فتحها. ويمكن للغة JavaScript من جهة العميل إجراء استدعاءات غير متزامنة من جانب الخادم باستخدام google.script.run() ووظائف المعالجات المرتبطة بها. لمزيد من التفاصيل، راجع التواصل من عميل إلى خادم.