তাস

একটি কার্ড-ভিত্তিক অ্যাড-অন সাইডবারে একটি ফলক হিসাবে উপস্থিত হয় (অথবা, মোবাইলে, মেনুর মাধ্যমে অন্য একটি অ্যাক্টিভিটি উইন্ডোতে পৌঁছে)। অ্যাড-অনে একটি শীর্ষ টুলবার রয়েছে যা অ্যাড-অন সনাক্ত করে এবং একটি কার্ড প্রদর্শন করে — মূলত অ্যাড-অনের UI-এর একটি "পৃষ্ঠা"৷ Apps Script Card অবজেক্ট ব্যবহার করে প্রজেক্ট কোডে কার্ড উপস্থাপন করে।

কার্ড অ্যানাটমি

অ্যাড-অন কার্ডের উদাহরণ

একটি কার্ড হল UI উপাদানগুলির একটি গ্রুপ যা আপনি ডিজাইন করেন। একটি কার্ড নিম্নলিখিত বিভাগগুলি নিয়ে গঠিত:

  • একটি কার্ড হেডার । এটি কার্ডগুলি সনাক্ত করে। এটিতে শিরোনাম পাঠ্য রয়েছে এবং ঐচ্ছিকভাবে একটি সাবটাইটেল এবং একটি আইকন থাকতে পারে৷

  • এক বা একাধিক কার্ড বিভাগ । এগুলি কার্ডের UI এলাকার উপ-বিভাগ। একটি বিভাগে ঐচ্ছিকভাবে একটি পাঠ্য বিভাগের শিরোনাম থাকতে পারে। কার্ড বিভাগগুলি একটি অনুভূমিক নিয়ম দ্বারা কার্ডে একে অপরের থেকে পৃথক করা হয়। যদি একটি কার্ড বিভাগ বিশেষভাবে বড় হয়, তবে এটি স্বয়ংক্রিয়ভাবে একটি সংকোচনযোগ্য বিভাগ হিসাবে রেন্ডার করা হয় যা ব্যবহারকারীরা প্রয়োজন অনুসারে প্রসারিত বা ভেঙে পড়তে পারে। একটি কার্ডে 100টির বেশি কার্ড বিভাগ থাকতে পারে না এবং আরও ভালো পারফরম্যান্সের জন্য শুধুমাত্র কয়েকটি থাকা উচিত।

  • প্রতিটি কার্ড বিভাগে এক বা একাধিক UI উইজেট থাকে । উইজেট ব্যবহারকারীকে তথ্য বা ইন্টারেক্টিভ নিয়ন্ত্রণ প্রদান করে। কার্ড এবং কার্ড বিভাগগুলি স্ট্রাকচারাল উইজেট, তাই আপনি সেগুলিকে একটি কার্ড বিভাগে যোগ করতে পারবেন না। একটি কার্ড বিভাগে 100 টির বেশি উইজেট থাকতে পারে না এবং সেরা পারফরম্যান্সের জন্য যতটা সম্ভব সহজ হওয়া উচিত।

আপনার নির্দিষ্ট ব্যবহারকারীর কার্যকলাপ বা ডেটা সেটের চারপাশে কার্ড ডিজাইন করা উচিত। যেমন, একটি Google Workspace অ্যাড-অন যা Google শীট থেকে নেওয়া ডেটা প্রদর্শন করে যেটি থেকে ডেটা টেনে নেওয়া প্রতিটি শিটের জন্য আলাদা কার্ড থাকতে পারে।

একাধিক কার্ড ব্যবহার করে

অ্যাড-অন কার্ডের উদাহরণ

অ্যাড-অনগুলিতে সাধারণত একাধিক কার্ড থাকে। আপনি হয় একাধিক কার্ড সহ মৌলিক নেভিগেশনের জন্য এই কার্ডগুলিকে একটি সাধারণ তালিকা হিসাবে কনফিগার করতে পারেন, অথবা ব্যবহারকারী কীভাবে কার্ডগুলির মধ্যে চলে যায় তা নিয়ন্ত্রণ করতে আরও জটিল নেভিগেশন পদ্ধতিগুলি কনফিগার করতে পারেন৷

অ্যাড-অন যদি বেসিক নেভিগেশন ব্যবহার করে, যখন অ্যাড-অনটি প্রথম Google Workspace অ্যাপ্লিকেশানটি খোলা হয় তখন এটি কার্ড হেডারগুলির একটি তালিকা তৈরি করে এবং ব্যবহারকারীর কাছে উপস্থাপন করে। কার্ড হেডারে ক্লিক করলে সেই কার্ডটি খোলে। কার্ড শিরোনাম তালিকা ফিরে পেতে একটি পিছনে তীর এছাড়াও প্রদান করা হয়. আপনাকে হেডার এবং ব্যাক অ্যারো কার্যকারিতা কোড করতে হবে না - যখন আপনি আপনার অ্যাড-অনে কার্ডগুলিকে সংজ্ঞায়িত করেন তখন এটি স্বয়ংক্রিয়ভাবে সম্পন্ন হয়৷

অ্যাড-অন ডিজাইন করার সময়, আপনি একবারে প্রদর্শিত কার্ডের সংখ্যা সীমিত করা ভাল, যেহেতু কার্ডগুলিকে অবশ্যই সীমিত পরিমাণ স্ক্রীন স্পেস শেয়ার করতে হবে। কার্ডগুলিতে অপ্রয়োজনীয় জটিলতা এড়ানোও ভাল৷