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

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

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

مربّعات حوار

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

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

  1. أنشئ ملف مشروع نص برمجي يحدد هيكل HTML لمربع الحوار، وCSS وسلوك JavaScript من جهة العميل. عند تحديد مربع الحوار، قم بالرجوع إرشادات نمط إضافة المحرِّر.
  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 Picker.

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

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

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

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

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

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

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