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 के बीच की कोई फ़्लोट संख्या होनी चाहिए. इसमें 0 (0/255) का मतलब है कि कोई रंग नहीं है और 1 (255/255) का मतलब है कि रंग की तीव्रता सबसे ज़्यादा है.

उदाहरण के लिए, यहां दिए गए कोड से रंग को सबसे ज़्यादा इंटेंसिटी के साथ लाल पर सेट किया जाता है:

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

बटन के रंग के लिए, alpha फ़ील्ड उपलब्ध नहीं है. अगर इस फ़ील्ड की वैल्यू दी जाती है, तो उसे अनदेखा कर दिया जाता है.

onClick

object (OnClick)

ज़रूरी है. बटन पर क्लिक करने पर होने वाली कार्रवाई. जैसे, हाइपरलिंक खोलना या कोई कस्टम फ़ंक्शन चलाना.

disabled

boolean

अगर true है, तो बटन बंद स्थिति में दिखता है और उपयोगकर्ता की कार्रवाइयों का जवाब नहीं देता.

altText

string

सुलभता के लिए इस्तेमाल किया जाने वाला वैकल्पिक टेक्स्ट.

जानकारी देने वाला ऐसा टेक्स्ट सेट करें जिससे उपयोगकर्ताओं को पता चले कि बटन क्या काम करता है. उदाहरण के लिए, अगर कोई बटन हाइपरलिंक खोलता है, तो यह लिखा जा सकता है: "यह बटन, ब्राउज़र का नया टैब खोलता है और https://developers.google.com/workspace/chat" पर मौजूद Google Chat के डेवलपर दस्तावेज़ पर ले जाता है.

type

enum (Type)

ज़रूरी नहीं. बटन का टाइप. अगर इस नीति को सेट नहीं किया जाता है, तो बटन का टाइप डिफ़ॉल्ट रूप से OUTLINED पर सेट होता है. अगर color फ़ील्ड सेट है, तो बटन टाइप को FILLED पर सेट कर दिया जाता है. साथ ही, इस फ़ील्ड के लिए सेट की गई किसी भी वैल्यू को अनदेखा कर दिया जाता है.

टाइप

ज़रूरी नहीं. बटन का टाइप. अगर color फ़ील्ड सेट है, तो type को FILLED पर सेट करना ज़रूरी है.

यह Google Chat ऐप्लिकेशन के लिए उपलब्ध है और Google Workspace ऐड-ऑन के लिए उपलब्ध नहीं है.

Enums
TYPE_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
OUTLINED आउटलाइन वाले बटन, मीडियम-एम्फ़सिस बटन होते हैं. इनमें आम तौर पर ऐसी कार्रवाइयां शामिल होती हैं जो ज़रूरी होती हैं, लेकिन वे किसी चैट ऐप्लिकेशन या ऐड-ऑन में मुख्य कार्रवाई नहीं होतीं.
FILLED फ़िल्ड बटन में एक कंटेनर होता है, जिसमें सॉलिड कलर होता है. यह सबसे ज़्यादा विज़ुअल इंपैक्ट डालता है. इसलिए, इसे चैट ऐप्लिकेशन या ऐड-ऑन में ज़रूरी और मुख्य कार्रवाई के लिए इस्तेमाल करने का सुझाव दिया जाता है.
FILLED_TONAL फ़िल्ड टोनल बटन, फ़िल्ड और आउटलाइन वाले बटन के बीच का एक विकल्प है. इनका इस्तेमाल तब किया जाता है, जब कम प्राथमिकता वाले बटन पर आउटलाइन बटन की तुलना में थोड़ा ज़्यादा ज़ोर देने की ज़रूरत होती है.
BORDERLESS डिफ़ॉल्ट स्थिति में, बटन में कोई ऐसा कंटेनर नहीं होता जो दिखता न हो. इसका इस्तेमाल अक्सर सबसे कम प्राथमिकता वाली कार्रवाइयों के लिए किया जाता है. खास तौर पर, तब जब कई विकल्प दिखाए जा रहे हों.