একটি কার্ড-ভিত্তিক অ্যাড-অন সাইডবারে একটি প্যান হিসেবে প্রদর্শিত হয় (অথবা, মোবাইলে, মেনু দিয়ে পৌঁছানো অন্য একটি অ্যাক্টিভিটি উইন্ডো হিসেবে)। অ্যাড-অনটিতে একটি শীর্ষ টুলবার রয়েছে যা অ্যাড-অনটিকে সনাক্ত করে এবং একটি কার্ড প্রদর্শন করে — মূলত অ্যাড-অনের UI এর একটি "পৃষ্ঠা"। অ্যাপস স্ক্রিপ্ট Card অবজেক্ট ব্যবহার করে প্রজেক্ট কোডে কার্ডগুলিকে উপস্থাপন করে।
কার্ড অ্যানাটমি
একটি কার্ড হল আপনার ডিজাইন করা UI উপাদানগুলির একটি গ্রুপ। একটি কার্ডে নিম্নলিখিত বিভাগগুলি থাকে:
- একটি কার্ড হেডার । এটি কার্ডগুলিকে শনাক্ত করে। এতে শিরোনাম লেখা আছে, এবং ঐচ্ছিকভাবে একটি সাবটাইটেল এবং একটি আইকন থাকতে পারে।
এক বা একাধিক কার্ড বিভাগ । এগুলি কার্ডের UI এলাকার উপ-বিভাগ। একটি বিভাগে ঐচ্ছিকভাবে একটি টেক্সট বিভাগ শিরোনাম থাকতে পারে। কার্ড বিভাগগুলি একটি অনুভূমিক নিয়ম দ্বারা কার্ডে একে অপরের থেকে পৃথক করা হয়। যদি একটি কার্ড বিভাগ বিশেষভাবে বড় হয়, তবে এটি স্বয়ংক্রিয়ভাবে একটি সংকোচনযোগ্য বিভাগ হিসাবে রেন্ডার করা হয় যা ব্যবহারকারীরা প্রয়োজন অনুসারে প্রসারিত বা সংকোচন করতে পারেন। একটি কার্ডে 100 টির বেশি কার্ড বিভাগ থাকতে পারে না এবং আরও ভাল পারফরম্যান্সের জন্য কেবল কয়েকটি থাকা উচিত।
প্রতিটি কার্ড বিভাগে এক বা একাধিক UI উইজেট থাকে । উইজেটগুলি ব্যবহারকারীকে তথ্য বা ইন্টারেক্টিভ নিয়ন্ত্রণ প্রদান করে। কার্ড এবং কার্ড বিভাগগুলি কাঠামোগত উইজেট, তাই আপনি এগুলি একটি কার্ড বিভাগে যোগ করতে পারবেন না। একটি কার্ড বিভাগে 100 টির বেশি উইজেট থাকতে পারে না এবং সর্বোত্তম কর্মক্ষমতার জন্য যতটা সম্ভব সহজ হওয়া উচিত।
আপনার নির্দিষ্ট ব্যবহারকারীর কার্যকলাপ বা ডেটা সেটের উপর ভিত্তি করে কার্ড ডিজাইন করা উচিত। উদাহরণস্বরূপ, একটি Google Workspace অ্যাড-অন যা Google Sheets থেকে নেওয়া ডেটা প্রদর্শন করে, প্রতিটি শীটের জন্য একটি পৃথক কার্ড থাকতে পারে যা থেকে এটি ডেটা সংগ্রহ করে।
একাধিক কার্ড ব্যবহার করা
অ্যাড-অনগুলিতে সাধারণত একাধিক কার্ড থাকে। আপনি একাধিক কার্ডের সাথে মৌলিক নেভিগেশনের জন্য এই কার্ডগুলিকে একটি সহজ তালিকা হিসাবে কনফিগার করতে পারেন, অথবা ব্যবহারকারী কার্ডগুলির মধ্যে কীভাবে চলাচল করে তা নিয়ন্ত্রণ করার জন্য আরও জটিল নেভিগেশন পদ্ধতি কনফিগার করতে পারেন।
যদি অ্যাড-অনটি বেসিক নেভিগেশন ব্যবহার করে, তাহলে অ্যাড-অনটি প্রথম খোলার সময় Google Workspace অ্যাপ্লিকেশনটি কার্ড হেডারগুলির একটি তালিকা তৈরি করে এবং ব্যবহারকারীর কাছে উপস্থাপন করে। কার্ড হেডারে ক্লিক করলে সেই কার্ডটি খোলে। কার্ড হেডার তালিকায় ফিরে যাওয়ার জন্য একটি ব্যাক অ্যারোও দেওয়া হয়। আপনাকে হেডার এবং ব্যাক অ্যারো কার্যকারিতা কোড করতে হবে না - এটি স্বয়ংক্রিয়ভাবে সম্পন্ন হয় যখন আপনি আপনার অ্যাড-অনে কার্ডগুলি সংজ্ঞায়িত করেন।
অ্যাড-অন ডিজাইন করার সময়, একসাথে প্রদর্শিত কার্ডের সংখ্যা সীমিত করাই ভালো, কারণ কার্ডগুলিকে সীমিত পরিমাণে স্ক্রিন স্পেস ভাগ করে নিতে হবে। কার্ডগুলিতে অপ্রয়োজনীয় জটিলতা এড়ানোও ভালো।