একটি কর্ম বাস্তবায়ন

যখন কোনো ব্যবহারকারী টুলবার আইকনে ক্লিক করেন, যা সাধারণত আপনার এক্সটেনশনের জন্য অ্যাকশন আইকন নামে পরিচিত, তখন যা ঘটে তাকেই একটি অ্যাকশন বলা হয়। একটি অ্যাকশন, অ্যাকশন এপিআই (Action API) ব্যবহার করে এক্সটেনশনের কোনো ফিচার চালু করে অথবা একটি পপআপ খোলে। এই পৃষ্ঠায় দেখানো হয়েছে কীভাবে এক্সটেনশনের কোনো ফিচার চালু করতে হয়। পপআপ ব্যবহার করতে, ‘একটি পপআপ যোগ করুন’ (Add a popup) দেখুন।

পদক্ষেপটি নিবন্ধন করুন

chrome.action API ব্যবহার করতে, এক্সটেনশনের ম্যানিফেস্ট ফাইলে "action" কী-টি যোগ করুন। এই ফিল্ডের ঐচ্ছিক প্রোপার্টিগুলোর সম্পূর্ণ বিবরণের জন্য chrome.action API রেফারেন্সের ম্যানিফেস্ট সেকশনটি দেখুন।

manifest.json:

{
  "name": "My Awesome action Extension",
 ...
  "action": {
   ...
  }
 ...
}

পদক্ষেপটির প্রতিক্রিয়া জানান

ব্যবহারকারী অ্যাকশন আইকনে ক্লিক করলে তার জন্য একটি onClicked হ্যান্ডলার রেজিস্টার করুন। manifest.json ফাইলে কোনো পপআপ রেজিস্টার করা থাকলে এই ইভেন্টটি ট্রিগার হয় না।

service-worker.js:

chrome.action.onClicked.addListener((tab) => {
  chrome.action.setTitle({
    tabId: tab.id,
    title: `You are on tab: ${tab.id}`});
});

শর্তসাপেক্ষে অ্যাকশনটি সক্রিয় করুন

chrome.declarativeContent API আপনাকে পেজের URL-এর উপর ভিত্তি করে অথবা যখন CSS সিলেক্টর পেজের এলিমেন্টগুলোর সাথে মিলে যায়, তখন এক্সটেনশনের অ্যাকশন আইকনটি সক্রিয় করার সুযোগ দেয়। যখন কোনো এক্সটেনশনের অ্যাকশন আইকন নিষ্ক্রিয় থাকে, তখন আইকনটি ধূসর হয়ে যায়। ব্যবহারকারী নিষ্ক্রিয় আইকনটিতে ক্লিক করলে, এক্সটেনশনটির কনটেক্সট মেনু প্রদর্শিত হয়।

অ্যাকশন ব্যাজ

ব্যাজ হলো অ্যাকশন আইকনের উপরে রাখা ফরম্যাট করা কিছু টেক্সট, যা এক্সটেনশনের অবস্থা বা ব্যবহারকারীর কোনো পদক্ষেপের প্রয়োজনীয়তার মতো বিষয়গুলো নির্দেশ করে। এটি বোঝানোর জন্য, ‘ ড্রিঙ্ক ওয়াটার’ নমুনাটিতে একটি "ON" লেখা ব্যাজ দেখানো হয়, যা ব্যবহারকারীকে বোঝায় যে তিনি সফলভাবে একটি অ্যালার্ম সেট করেছেন এবং এক্সটেনশনটি নিষ্ক্রিয় থাকলে কিছুই প্রদর্শন করে না। একটি ব্যাজে সর্বোচ্চ চারটি অক্ষর থাকতে পারে।

chrome.action.setBadgeText() কল করে ব্যাজের টেক্সট এবং chrome.action.setBadgeBackgroundColor() কল করে ব্যাকগ্রাউন্ড কালার সেট করুন।

service-worker.js:

chrome.action.setBadgeText({text: 'ON'});
chrome.action.setBadgeBackgroundColor({color: '#4688F1'});

টুলটিপ

manifest.json ফাইলের "action" কী-এর অধীনে "default_title" ফিল্ডে টুলটিপগুলো রেজিস্টার করুন।

manifest.json:

{
  "name": "Tab Flipper",
 ...
  "action": {
    "default_title": "Press Ctrl(Win)/Command(Mac)+Shift+Right/Left to flip tabs"
  }
...
}

আপনি action.setTitle() কল করে টুলটিপ সেট বা আপডেট করতে পারেন। যদি কোনো টুলটিপ সেট করা না থাকে, তাহলে এক্সটেনশনটির নাম প্রদর্শিত হয়।