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 مشخص کنید. این مقدار باید عدد اعشاری بین ۰ و ۱ براساس مقدار رنگ RGB باشد، که در آن 0 (۰/۲۵۵) نشان‌دهنده عدم وجود رنگ و 1 (۲۵۵/۲۵۵) نشان‌دهنده حداکثر شدت رنگ است.

برای مثال، کد زیر رنگ را روی قرمز با حداکثر شدت تنظیم می‌کند:

"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 تنظیم شده باشد، type به FILLED اجبار می‌شود.

برای برنامه‌های Google Chat دردسترس است و برای برافزاهای Google Workspace دردسترس نیست.

شمارشی‌ها
TYPE_UNSPECIFIED استفاده نشود. نامشخص.
OUTLINED دکمه‌های حاشیه‌دار دکمه‌هایی با تأکید متوسط هستند. این منوها معمولاً حاوی کنش‌هایی هستند که مهم‌اند اما کنش اصلی در برنامه Chat یا برافزا نیستند.
FILLED دکمه توپر دارای محفظه‌ای با رنگ یکدست است. این دکمه بیشترین تأثیر دیداری را دارد و برای کنش مهم و اصلی در برنامه Chat یا برافزا توصیه می‌شود.
FILLED_TONAL دکمه رنگی توپر جایگزینی بین دکمه‌های توپر و دکمه‌های حاشیه‌دار است. این دکمه‌ها در زمینه‌هایی مفید هستند که دکمه‌ای با اولویت پایین‌تر به تأکید کمی بیشتر از آنچه دکمه حاشیه‌دار ارائه می‌دهد نیاز دارد.
BORDERLESS دکمه در حالت پیش‌فرض خود محفظه نامرئی ندارد. اغلب برای کنش‌های با کمترین اولویت استفاده می‌شود، به‌ویژه هنگام ارائه چندین گزینه.