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