OnClick

• تمثيل JSON
• OpenLink
  • تمثيل JSON
• OpenAs
• OnClose
• OverflowMenu
  • تمثيل JSON
• OverflowMenuItem
  • تمثيل JSON

يمثّل كيفية الاستجابة عندما ينقر المستخدمون على عنصر تفاعلي في بطاقة، مثل زر.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

تمثيل JSON
{ "action": { object (Action) }, "openLink": { object (OpenLink) }, "openDynamicLinkAction": { object (Action) }, "card": { object (Card) }, "overflowMenu": { object (OverflowMenu) } }

الحقول
في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
action	object (Action) في حال تحديد هذا الحقل، يتم تنفيذ إجراء من خلال onClick.
openLink	object (OpenLink) في حال تحديد هذا الخيار، يؤدي onClick إلى تنفيذ إجراء فتح الرابط.
openDynamicLinkAction	object (Action) تُشغِّل الإضافة هذا الإجراء عندما يحتاج الإجراء إلى فتح رابط. يختلف هذا عن openLink أعلاه في أنّه يحتاج إلى التواصل مع الخادم للحصول على الرابط. وبالتالي، يجب أن ينفّذ عميل الويب بعض أعمال التحضير قبل أن يتلقّى ردًّا على إجراء فتح الرابط. متاحة لإضافات Google Workspace وغير متاحة لتطبيقات Google Chat.
card	object (Card) تتم إضافة بطاقة جديدة إلى حزمة البطاقات بعد النقر عليها إذا تم تحديد ذلك. متاحة لإضافات Google Workspace وغير متاحة لتطبيقات Google Chat.
overflowMenu	object (OverflowMenu) في حال تحديد هذا الخيار، سيفتح onClick قائمة كاملة.
نهاية الحقول التي يستبعد كلّ منها الآخر

OpenLink

يمثّل حدث onClick يفتح رابطًا تشعّبيًا.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

تمثيل JSON
{ "url": string, "openAs": enum (OpenAs), "onClose": enum (OnClose) }

الحقول
url	string عنوان URL المطلوب فتحه يتم تحويل عناوين URL التي تستخدم HTTP إلى HTTPS.
openAs	enum (OpenAs) كيفية فتح رابط متاحة لإضافات Google Workspace وغير متاحة لتطبيقات Google Chat.
onClose	enum (OnClose) ما إذا كان العميل ينسى الرابط بعد فتحه أو يراقبه حتى يتم إغلاق النافذة. متاحة لإضافات Google Workspace وغير متاحة لتطبيقات Google Chat.

OpenAs

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

متاحة لإضافات Google Workspace وغير متاحة لتطبيقات Google Chat.

عمليات التعداد
FULL_SIZE	يتم فتح الرابط كنافذة بالحجم الكامل (إذا كان هذا هو الإطار الذي يستخدمه العميل).
OVERLAY	يتم فتح الرابط كتراكب، مثل نافذة منبثقة.

OnClose

ما يفعله العميل عند إغلاق رابط تم فتحه من خلال إجراء OnClick.

يعتمد التنفيذ على إمكانات منصة العميل. على سبيل المثال، قد يفتح متصفّح الويب رابطًا في نافذة منبثقة باستخدام معالج OnClose.

في حال ضبط معالجَي OnOpen وOnClose، ولم تكن منصة العميل متوافقة مع كلتا القيمتَين، تكون الأولوية لـ OnClose.

متاحة لإضافات Google Workspace وغير متاحة لتطبيقات Google Chat.

عمليات التعداد
NOTHING	القيمة التلقائية لا تتم إعادة تحميل البطاقة، ولا يحدث أي شيء.
RELOAD	يعيد تحميل البطاقة بعد إغلاق النافذة الفرعية. في حال استخدامها مع OpenAs.OVERLAY، تعمل النافذة الفرعية كمربّع حوار مشروط ويتم حظر البطاقة الرئيسية إلى أن يتم إغلاق النافذة الفرعية.

OverflowMenu

تطبيق مصغّر يعرض قائمة منبثقة تتضمّن إجراءً واحدًا أو أكثر يمكن للمستخدمين تنفيذه. على سبيل المثال، عرض الإجراءات غير الأساسية في بطاقة. يمكنك استخدام هذا التطبيق المصغّر عندما لا تتناسب الإجراءات مع المساحة المتاحة. لاستخدامها، حدِّد هذه الأداة في الإجراء OnClick للأدوات التي تتيحها. على سبيل المثال، في Button.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

تمثيل JSON
{ "items": [ { object (OverflowMenuItem) } ] }

الحقول
items[]	object (OverflowMenuItem) الحقل مطلوب. قائمة خيارات القائمة

OverflowMenuItem

خيار يمكن للمستخدمين استدعاؤه في قائمة الكاملة.

تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.

تمثيل JSON
{ "startIcon": { object (Icon) }, "text": string, "onClick": { object (OnClick) }, "disabled": boolean }

الحقول
startIcon	object (Icon) الرمز المعروض أمام النص
text	string الحقل مطلوب. النص الذي يحدّد العنصر أو يصفه للمستخدمين.
onClick	object (OnClick) الحقل مطلوب. الإجراء الذي يتم استدعاؤه عند تحديد خيار من القائمة لا يمكن أن يحتوي OnClick هذا على OverflowMenu، ويتم تجاهل أي OverflowMenu محدّد ويتم إيقاف عنصر القائمة.
disabled	boolean ما إذا كان خيار القائمة غير مفعَّل الخيار التلقائي هو "خطأ".