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

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

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

مربّعات حوار

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

يمكنك إنشاء مربّعات حوار الإضافات بالطريقة نفسها التي تنشئ بها مربّعات الحوار المخصّصة في "برمجة تطبيقات Google". الإجراء العام هو:

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

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

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

مربّعات حوار فتح الملفات هي مربّعات حوار جاهزة تسمح للمستخدِمين باختيار ملفات من Google Drive. يمكنك إضافة مربّع حوار فتح الملفات إلى الإضافة بدون الحاجة إلى تصميمه، ولكن يتطلّب ذلك بعض الإعدادات الإضافية. يجب أيضًا أن يكون لديك إذن الوصول إلى مشروع Cloud Platform الخاص بالإضافة لتفعيل Google Picker API.

لمزيد من المعلومات، راجِع مربّعات حوار فتح الملفات.

الأشرطة الجانبية

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

يمكنك إنشاء أشرطة جانبية للإضافات بالطريقة نفسها التي تنشئ بها الأشرطة الجانبية المخصّصةفي "برمجة تطبيقات Google". الإجراء العام هو:

1. أنشِئ ملف مشروع نص برمجي يحدّد بنية HTML وCSS وسلوك JavaScript من جهة العميل للشريط الجانبي. عند تحديد الشريط الجانبي، راجِع إرشادات نمط إضافة المحرّر.

2. في الرمز من جهة الخادم الذي تريد فتح الشريط الجانبي فيه، استخدِم HtmlService.createHtmlOutputFromFile لإنشاء عنصر HtmlOutput يمثّل الشريط الجانبي. بدلاً من ذلك، إذا كنت تستخدم HTML مستندًا إلى نماذج، يمكنك استخدام HtmlService.createTemplateFromFile لإنشاء نموذج، ثم HtmlTemplate.evaluate لتحويله إلى عنصر HtmlOutput.

   يبلغ العرض الثابت للأشرطة الجانبية للإضافات 300 بكسل ، ولا يمكنك تغييره باستخدام HtmlOutput.setWidth.

3. استخدِم Ui.showSidebar لعرض الشريط الجانبي باستخدام HtmlOutput.

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