Button

زر نصي أو رمز أو زر نصي ورمز يمكن للمستخدمين النقر عليه. للحصول على مثال في تطبيقات Google Chat، يُرجى الاطّلاع على إضافة زر.

لجعل الصورة زرًا قابلاً للنقر، حدِّد Image (وليس ImageComponent) واضبط إجراء onClick.

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

تمثيل JSON 
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
الحقول
text

string

النص المعروض داخل الزر
icon

object (Icon)

رمز معروض داخل الزر في حال ضبط كل من icon وtext، سيظهر الرمز قبل النص.
color

object (Color)

اختياريّ. لون الزر في حال ضبط هذا الإعداد، يتم ضبط الزر type على FILLED ويتم ضبط لون الحقلَين text وicon على لون متباين لتسهيل القراءة. على سبيل المثال، إذا تم ضبط لون الزر على الأزرق، سيتم ضبط أي نص أو رموز في الزر على الأبيض.

لضبط لون الزر، حدِّد قيمة للحقول red وgreen وblue. يجب أن تكون القيمة عددًا عشريًا بين 0 و1 استنادًا إلى قيمة لون RGB، حيث يمثّل 0 (0/255) غياب اللون ويمثّل 1 (255/255) أقصى كثافة للون.

على سبيل المثال، يضبط ما يلي اللون على الأحمر بأقصى كثافة:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

الحقل alpha غير متاح للون الزر. في حال تحديد هذا الحقل، سيتم تجاهله.
onClick

object (OnClick)

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

boolean

إذا كانت القيمة true، يتم عرض الزر في حالة غير نشطة ولا يستجيب لإجراءات المستخدم.
altText

string

النص البديل الذي يُستخدَم لتسهيل الاستخدام

اضبط نصًا وصفيًا يتيح للمستخدمين معرفة وظيفة الزر. على سبيل المثال، إذا كان الزر يفتح رابطًا تشعبيًا، يمكنك كتابة: "يفتح علامة تبويب متصفّح جديدة وينتقل إلى مستندات مطوّري Google Chat على الرابط https://developers.google.com/workspace/chat".
type

enum (Type)

اختياريّ. نوع الزر وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط نوع الزر تلقائيًا على OUTLINED. في حال ضبط الحقل color، يتم فرض نوع الزر على FILLED ويتم تجاهل أي قيمة تم ضبطها لهذا الحقل.

النوع

اختياريّ. نوع الزر في حال ضبط الحقل color، يتم فرض FILLED على type.

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

عمليات التعداد
TYPE_UNSPECIFIED يجب عدم استخدامها. غير محدد
OUTLINED الأزرار المحدّدة هي أزرار متوسطة التركيز. وتحتوي عادةً على إجراءات مهمة، ولكنّها ليست الإجراء الأساسي في تطبيق Chat أو الإضافة.
FILLED يحتوي الزر المعبأ على حاوية بلون واحد. ويتميّز بأكبر تأثير مرئي، ويُنصح باستخدامه للإجراءات المهمة والأساسية في تطبيق Chat أو الإضافة.
FILLED_TONAL الزر المعبأ بلون واحد هو خيار بديل يتوسط الأزرار المعبأة والأزرار المحدَّدة الجوانب. وهي مفيدة في السياقات التي يتطلب فيها الزر ذو الأولوية المنخفضة تركيزًا أكبر قليلاً مما يوفره زر المخطط التفصيلي.
BORDERLESS لا يحتوي الزر على حاوية غير مرئية في حالته التلقائية. غالبًا ما يتم استخدامه للإجراءات ذات الأولوية الأدنى، خاصةً عند تقديم خيارات متعددة.