कार्ड-आधारित ऐड-ऑन, साइडबार में पैनल के तौर पर दिखता है. इसके अलावा, यह मोबाइल पर, मेन्यू से किसी अन्य गतिविधि विंडो पर पहुंचने पर भी दिखता है. ऐड-ऑन में सबसे ऊपर वाला टूलबार होता है, जो ऐड-ऑन की पहचान करता है. साथ ही, इसमें एक कार्ड दिखता है, जो ऐड-ऑन के यूज़र इंटरफ़ेस (यूआई) का एक "पेज" होता है. Apps Script, प्रोजेक्ट कोड में Card ऑब्जेक्ट का इस्तेमाल करके, कार्ड दिखाता है.
कार्ड की बनावट
कार्ड उन यूज़र इंटरफ़ेस (यूआई) एलिमेंट का एक ग्रुप है जिन्हें आपने डिज़ाइन किया है. कार्ड में ये सेक्शन होते हैं:
- कार्ड हेडर. यह कार्ड की पहचान करता है. इसमें टाइटल टेक्स्ट होता है. हो सकता है कि इसमें सबटाइटल और आइकॉन का इस्तेमाल करना ज़रूरी न हो.
एक या इससे ज़्यादा कार्ड के सेक्शन. ये कार्ड के यूज़र इंटरफ़ेस (यूआई) के सब-डिवीज़न हैं. किसी सेक्शन में वैकल्पिक तौर पर टेक्स्ट सेक्शन हेडर हो सकता है. कार्ड के सेक्शन, हॉरिज़ॉन्टल रूल के ज़रिए एक-दूसरे से अलग होते हैं. अगर कोई कार्ड सेक्शन खास तौर पर बड़ा होता है, तो वह एक ऐसे सेक्शन के तौर पर अपने-आप रेंडर हो जाता है जिसे छोटा या बड़ा किया जा सकता है. उपयोगकर्ता इस सेक्शन को अपनी ज़रूरत के हिसाब से बड़ा या छोटा कर सकते हैं. एक कार्ड में 100 से ज़्यादा कार्ड सेक्शन नहीं हो सकते. साथ ही, बेहतर परफ़ॉर्मेंस के लिए सिर्फ़ कुछ सेक्शन होने चाहिए.
हर कार्ड सेक्शन में एक या उससे ज़्यादा यूज़र इंटरफ़ेस (यूआई) विजेट होते हैं. विजेट से उपयोगकर्ता को जानकारी या इंटरैक्टिव कंट्रोल मिलते हैं. कार्ड और कार्ड सेक्शन स्ट्रक्चरल विजेट होते हैं, इसलिए आप उन्हें कार्ड सेक्शन में नहीं जोड़ सकते. एक कार्ड सेक्शन में 100 से ज़्यादा विजेट नहीं हो सकते. साथ ही, बेहतरीन परफ़ॉर्मेंस के लिए इन्हें जितना हो सके उतना आसान होना चाहिए.
आपको खास उपयोगकर्ता गतिविधियों या डेटा सेट के हिसाब से कार्ड डिज़ाइन करने चाहिए. जैसे, Google Sheets से लिया गया डेटा दिखाने वाले Google Workspace ऐड-ऑन में, हर शीट के लिए एक अलग कार्ड हो सकता है.
एक से ज़्यादा कार्ड का इस्तेमाल करना
आम तौर पर, ऐड-ऑन में एक से ज़्यादा कार्ड होते हैं. एक से ज़्यादा कार्ड की मदद से सामान्य नेविगेशन के लिए, इन कार्ड को आसान सूची के तौर पर कॉन्फ़िगर किया जा सकता है. इसके अलावा, उपयोगकर्ता के कार्ड के बीच स्विच करने के तरीके को कंट्रोल करने के लिए, ज़्यादा मुश्किल नेविगेशन के तरीके कॉन्फ़िगर किए जा सकते हैं.
अगर ऐड-ऑन, बेसिक नेविगेशन का इस्तेमाल करता है, तो ऐड-ऑन को पहली बार Google Workspace ऐप्लिकेशन खोलने पर, यह कार्ड के हेडर की एक सूची बनाता है और उन्हें उपयोगकर्ता को दिखाता है. कार्ड हेडर पर क्लिक करने से वह कार्ड खुल जाता है. कार्ड हेडर सूची पर वापस जाने के लिए बैक ऐरो भी दिया जाता है. आपको हेडर और बैक ऐरो फ़ंक्शन को कोड करने की ज़रूरत नहीं है—अपने ऐड-ऑन में कार्ड तय करने पर यह अपने-आप हो जाता है.
ऐड-ऑन डिज़ाइन करते समय, एक बार में दिखाए जाने वाले कार्ड की संख्या सीमित करना बेहतर होता है, क्योंकि कार्ड के लिए स्क्रीन पर सीमित जगह की ज़रूरत होती है. कार्ड में गैर-ज़रूरी जटिलताओं से बचें.