chrome.action

বর্ণনা

Google Chrome টুলবারে এক্সটেনশনের আইকন নিয়ন্ত্রণ করতে chrome.action API ব্যবহার করুন।

অ্যাকশন আইকনগুলি অম্নিবক্সের পাশে ব্রাউজার টুলবারে প্রদর্শিত হয়৷ ইনস্টলেশনের পরে, এগুলি এক্সটেনশন মেনুতে উপস্থিত হয় (ধাঁধা অংশ আইকন)। ব্যবহারকারীরা টুলবারে আপনার এক্সটেনশন আইকন পিন করতে পারেন।

উপস্থিতি

Chrome 88+ MV3+

উদ্ভাসিত

এই API ব্যবহার করার জন্য নিম্নলিখিত কীগুলি অবশ্যই ম্যানিফেস্টে ঘোষণা করতে হবে৷

"action"

chrome.action API ব্যবহার করতে, 3 এর একটি "manifest_version" নির্দিষ্ট করুন এবং আপনার ম্যানিফেস্ট ফাইলে "action" কী অন্তর্ভুক্ত করুন।

দ্রষ্টব্য: প্রতিটি এক্সটেনশনের Chrome টুলবারে একটি আইকন থাকে, এমনকি যদি `"অ্যাকশন"` কী ম্যানিফেস্টে যোগ না করা হয়।

{
  "name": "Action Extension",
  ...
  "action": {
    "default_icon": {              // optional
      "16": "images/icon16.png",   // optional
      "24": "images/icon24.png",   // optional
      "32": "images/icon32.png"    // optional
    },
    "default_title": "Click Me",   // optional, shown in tooltip
    "default_popup": "popup.html"  // optional
  },
  ...
}

"action" কী (এর বাচ্চাদের সাথে) ঐচ্ছিক। যখন এটি অন্তর্ভুক্ত করা হয় না, তখনও এক্সটেনশনের মেনুতে অ্যাক্সেস দেওয়ার জন্য আপনার এক্সটেনশন টুলবারে দেখানো হয়। এই কারণে, আমরা সুপারিশ করি যে আপনি সর্বদা অন্তত "action" এবং "default_icon" কীগুলি অন্তর্ভুক্ত করুন৷

ধারণা এবং ব্যবহার

UI এর অংশ

আইকন

আইকনটি আপনার এক্সটেনশনের টুলবারে প্রধান চিত্র, এবং আপনার ম্যানিফেস্টের "action" কী-তে "default_icon" কী দ্বারা সেট করা হয়৷ আইকন 16 ডিভাইস-স্বাধীন পিক্সেল (DIPs) চওড়া এবং লম্বা হতে হবে।

"default_icon" কী হল চিত্র পাথের আকারের একটি অভিধান। কোন চিত্র স্কেল ব্যবহার করতে হবে তা চয়ন করতে Chrome এই আইকনগুলি ব্যবহার করে৷ যদি একটি সঠিক মিল খুঁজে না পাওয়া যায়, Chrome সবচেয়ে কাছের উপলব্ধটি নির্বাচন করে এবং এটিকে চিত্রের সাথে মানানসই করার জন্য স্কেল করে, যা ছবির গুণমানকে প্রভাবিত করতে পারে।

যেহেতু 1.5x বা 1.2x এর মতো কম-সাধারণ স্কেল ফ্যাক্টর সহ ডিভাইসগুলি আরও সাধারণ হয়ে উঠছে, আমরা আপনাকে আপনার আইকনগুলির জন্য একাধিক মাপ প্রদান করতে উত্সাহিত করি৷ এটি সম্ভাব্য আইকন প্রদর্শনের আকার পরিবর্তনের বিরুদ্ধে আপনার এক্সটেনশনকে ভবিষ্যতে প্রমাণ করে।

এছাড়াও আপনি একটি ভিন্ন চিত্রের পথ নির্দিষ্ট করে বা HTML ক্যানভাস উপাদান ব্যবহার করে একটি গতিশীল-উত্পন্ন আইকন প্রদান করে আপনার এক্সটেনশনের আইকনটি প্রোগ্রামগতভাবে সেট করতে action.setIcon() এ কল করতে পারেন, অথবা, যদি কোনো এক্সটেনশন পরিষেবা কর্মী, অফস্ক্রিন ক্যানভাস API থেকে সেট করা হয়।

const canvas = new OffscreenCanvas(16, 16);
const context = canvas.getContext('2d');
context.clearRect(0, 0, 16, 16);
context.fillStyle = '#00FF00';  // Green
context.fillRect(0, 0, 16, 16);
const imageData = context.getImageData(0, 0, 16, 16);
chrome.action.setIcon({imageData: imageData}, () => { /* ... */ });

দ্রষ্টব্য: action.setIcon() API একটি স্ট্যাটিক ইমেজ সেট করার উদ্দেশ্যে করা হয়েছে। আপনার আইকনগুলির জন্য অ্যানিমেটেড ছবি ব্যবহার করবেন না।

প্যাকড এক্সটেনশনগুলির জন্য (একটি .crx ফাইল থেকে ইনস্টল করা), ছবিগুলি বেশিরভাগ ফর্ম্যাটে হতে পারে যা ব্লিঙ্ক রেন্ডারিং ইঞ্জিন প্রদর্শন করতে পারে, যার মধ্যে PNG, JPEG, BMP, ICO এবং অন্যান্য রয়েছে৷ SVG সমর্থিত নয়। আনপ্যাক করা এক্সটেনশনগুলিকে অবশ্যই PNG ছবি ব্যবহার করতে হবে।

টুলটিপ (শিরোনাম)

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

ডিফল্ট টুলটিপটি manifest.json এ "action" কী-এর "default_title" ক্ষেত্র ব্যবহার করে সেট করা হয়েছে। এছাড়াও আপনি action.setTitle() এ কল করে প্রোগ্রামগতভাবে এটি সেট করতে পারেন।

ব্যাজ

ক্রিয়াগুলি ঐচ্ছিকভাবে একটি "ব্যাজ" প্রদর্শন করতে পারে — আইকনের উপর স্তরযুক্ত কিছু পাঠ্য। এটি আপনাকে এক্সটেনশনের অবস্থা, যেমন একটি কাউন্টার সম্পর্কে অল্প পরিমাণ তথ্য প্রদর্শনের জন্য অ্যাকশন আপডেট করতে দেয়। ব্যাজটিতে একটি পাঠ্য উপাদান এবং একটি পটভূমির রঙ রয়েছে৷ যেহেতু স্থান সীমিত, আমরা সুপারিশ করি যে ব্যাজ পাঠ্য চার বা তার কম অক্ষর ব্যবহার করুন।

একটি ব্যাজ তৈরি করতে, কর্মসূচীতে এটি সেট করুন action.setBadgeBackgroundColor() এবং action.setBadgeText() কল করে। ম্যানিফেস্টে কোনো ডিফল্ট ব্যাজ সেটিং নেই। ব্যাজের রঙের মান 0 থেকে 255 এর মধ্যে চারটি পূর্ণসংখ্যার একটি অ্যারে হতে পারে যা ব্যাজের RGBA রঙ বা একটি CSS রঙের মান সহ একটি স্ট্রিং তৈরি করে।

chrome.action.setBadgeBackgroundColor(
  {color: [0, 255, 0, 0]},  // Green
  () => { /* ... */ },
);

chrome.action.setBadgeBackgroundColor(
  {color: '#00FF00'},  // Also green
  () => { /* ... */ },
);

chrome.action.setBadgeBackgroundColor(
  {color: 'green'},  // Also, also green
  () => { /* ... */ },
);

পপআপ

যখন ব্যবহারকারী টুলবারে এক্সটেনশনের অ্যাকশন বোতামে ক্লিক করেন তখন একটি অ্যাকশনের পপআপ দেখানো হয়। পপআপে আপনার পছন্দের যেকোনো HTML বিষয়বস্তু থাকতে পারে এবং স্বয়ংক্রিয়ভাবে এর বিষয়বস্তুর সাথে মানানসই আকার দেওয়া হবে। পপআপের আকার অবশ্যই 25x25 এবং 800x600 পিক্সেলের মধ্যে হতে হবে।

পপআপটি প্রাথমিকভাবে manifest.json ফাইলের "action" কী-তে "default_popup" বৈশিষ্ট্য দ্বারা সেট করা হয়। যদি উপস্থিত থাকে, এই বৈশিষ্ট্যটি এক্সটেনশন ডিরেক্টরির মধ্যে একটি আপেক্ষিক পথ নির্দেশ করবে। এটি action.setPopup() পদ্ধতি ব্যবহার করে একটি ভিন্ন আপেক্ষিক পথ নির্দেশ করার জন্য গতিশীলভাবে আপডেট করা যেতে পারে।

দ্রষ্টব্য: যদি এক্সটেনশন অ্যাকশন বর্তমান ট্যাবের ক্লিকে দেখানোর জন্য একটি পপআপ নির্দিষ্ট করে থাকে তাহলে action.onClicked ইভেন্টটি পাঠানো হবে না।

ব্যবহারের ক্ষেত্রে

প্রতি ট্যাব অবস্থা

প্রতিটি ট্যাবের জন্য এক্সটেনশন অ্যাকশনের বিভিন্ন অবস্থা থাকতে পারে। একটি পৃথক ট্যাবের জন্য একটি মান সেট করতে, action API এর সেটিং পদ্ধতিতে tabId বৈশিষ্ট্য ব্যবহার করুন। উদাহরণস্বরূপ, একটি নির্দিষ্ট ট্যাবের জন্য ব্যাজ পাঠ্য সেট করতে, নিম্নলিখিতগুলির মতো কিছু করুন:

function getTabId() { /* ... */}
function getTabBadge() { /* ... */}

chrome.action.setBadgeText(
  {
    text: getTabBadge(tabId),
    tabId: getTabId(),
  },
  () => { ... }
);

যদি tabId প্রপার্টি বাদ দেওয়া হয়, সেটিংটিকে একটি গ্লোবাল সেটিং হিসাবে বিবেচনা করা হয়। ট্যাব-নির্দিষ্ট সেটিংস বিশ্বব্যাপী সেটিংসের চেয়ে অগ্রাধিকার নেয়।

সক্রিয় অবস্থা

ডিফল্টরূপে, প্রতিটি ট্যাবে টুলবার অ্যাকশন সক্রিয় (ক্লিকযোগ্য) থাকে। আপনি action.enable() এবং action.disable() পদ্ধতি ব্যবহার করে এটি নিয়ন্ত্রণ করতে পারেন। এটি শুধুমাত্র পপআপ (যদি থাকে) বা action.onClicked ইভেন্ট আপনার এক্সটেনশনে পাঠানো হয় কিনা তা প্রভাবিত করে; এটি টুলবারে কর্মের উপস্থিতি প্রভাবিত করে না।

উদাহরণ

নিম্নলিখিত উদাহরণগুলি কিছু সাধারণ উপায় দেখায় যেগুলি এক্সটেনশনগুলিতে ব্যবহৃত হয়৷ এই APIটি চেষ্টা করতে, chrome-extension-samples repository থেকে Action API উদাহরণটি ইনস্টল করুন৷

একটি পপআপ দেখান

যখন ব্যবহারকারী এক্সটেনশনের অ্যাকশনে ক্লিক করেন তখন একটি এক্সটেনশনের জন্য একটি পপআপ প্রদর্শন করা সাধারণ। আপনার নিজস্ব এক্সটেনশনে এটি বাস্তবায়ন করতে, আপনার manifest.json এ পপআপ ঘোষণা করুন এবং Chrome-এর পপআপে যে সামগ্রী প্রদর্শন করা উচিত তা নির্দিষ্ট করুন৷

// manifest.json
{
  "name": "Action popup demo",
  "version": "1.0",
  "manifest_version": 3,
  "action": {
    "default_title": "Click to view a popup",
    "default_popup": "popup.html"
  }
}

<!-- popup.html -->
<!DOCTYPE html>
<html>
<head>
  <style>
    html {
      min-height: 5em;
      min-width: 10em;
      background: salmon;
    }
  </style>
</head>
<body>
  <p>Hello, world!</p>
</body>
</html>

ক্লিকে একটি বিষয়বস্তু স্ক্রিপ্ট ইনজেক্ট করুন

এক্সটেনশনের জন্য একটি সাধারণ প্যাটার্ন হল এক্সটেনশনের ক্রিয়া ব্যবহার করে তাদের প্রাথমিক বৈশিষ্ট্যটি প্রকাশ করা। নিম্নলিখিত উদাহরণ এই প্যাটার্ন প্রদর্শন. যখন ব্যবহারকারী অ্যাকশনে ক্লিক করেন, তখন এক্সটেনশন বর্তমান পৃষ্ঠায় একটি বিষয়বস্তু স্ক্রিপ্ট ইনজেক্ট করে। বিষয়বস্তু স্ক্রিপ্ট তারপর সবকিছু প্রত্যাশিত হিসাবে কাজ করেছে তা যাচাই করার জন্য একটি সতর্কতা প্রদর্শন করে।

// manifest.json
{
  "name": "Action script injection demo",
  "version": "1.0",
  "manifest_version": 3,
  "action": {
    "default_title": "Click to show an alert"
  },
  "permissions": ["activeTab", "scripting"],
  "background": {
    "service_worker": "background.js"
  }
}

// background.js
chrome.action.onClicked.addListener((tab) => {
  chrome.scripting.executeScript({
    target: {tabId: tab.id},
    files: ['content.js']
  });
});

// content.js
alert('Hello, world!');

ঘোষণামূলক বিষয়বস্তু সহ কর্ম অনুকরণ করুন

এই উদাহরণটি দেখায় কিভাবে একটি এক্সটেনশনের ব্যাকগ্রাউন্ড লজিক (a) ডিফল্টরূপে একটি অ্যাকশনকে অক্ষম করতে পারে এবং (b) নির্দিষ্ট সাইটে অ্যাকশনটি সক্ষম করতে declarative Content ব্যবহার করতে পারে।

// service-worker.js

// Wrap in an onInstalled callback to avoid unnecessary work
// every time the service worker is run
chrome.runtime.onInstalled.addListener(() => {
  // Page actions are disabled by default and enabled on select tabs
  chrome.action.disable();

  // Clear all rules to ensure only our expected rules are set
  chrome.declarativeContent.onPageChanged.removeRules(undefined, () => {
    // Declare a rule to enable the action on example.com pages
    let exampleRule = {
      conditions: [
        new chrome.declarativeContent.PageStateMatcher({
          pageUrl: {hostSuffix: '.example.com'},
        })
      ],
      actions: [new chrome.declarativeContent.ShowAction()],
    };

    // Finally, apply our new array of rules
    let rules = [exampleRule];
    chrome.declarativeContent.onPageChanged.addRules(rules);
  });
});

প্রকারভেদ

OpenPopupOptions

Chrome 99+

বৈশিষ্ট্য

• উইন্ডো আইডি

  সংখ্যা ঐচ্ছিক

  অ্যাকশন পপআপ খোলার জন্য উইন্ডোর আইডি। অনির্দিষ্ট থাকলে বর্তমানে সক্রিয় উইন্ডোতে ডিফল্ট।

TabDetails

বৈশিষ্ট্য

• ট্যাবআইডি

  সংখ্যা ঐচ্ছিক

  ক্যোয়ারী করার জন্য ট্যাবের আইডি যদি কোন ট্যাব নির্দিষ্ট করা না থাকে, অ-ট্যাব-নির্দিষ্ট অবস্থা ফেরত দেওয়া হয়।

UserSettings

Chrome 91+

একটি এক্সটেনশনের ক্রিয়া সম্পর্কিত ব্যবহারকারী-নির্দিষ্ট সেটিংসের সংগ্রহ৷

বৈশিষ্ট্য

• isOnToolbar

  বুলিয়ান

  এক্সটেনশনের অ্যাকশন আইকন ব্রাউজার উইন্ডোজের শীর্ষ-স্তরের টুলবারে দৃশ্যমান কিনা (অর্থাৎ, ব্যবহারকারীর দ্বারা এক্সটেনশনটি 'পিন' করা হয়েছে কিনা)।

পদ্ধতি

disable()

প্রতিশ্রুতি

chrome.action.disable(
  tabId?: number,
  callback?: function,
)

একটি ট্যাবের জন্য কর্ম নিষ্ক্রিয় করে।

পরামিতি

• ট্যাবআইডি

  সংখ্যা ঐচ্ছিক

  ট্যাবের আইডি যার জন্য আপনি অ্যাকশনটি পরিবর্তন করতে চান।

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  ()=>void

রিটার্নস

• প্রতিশ্রুতি <void>

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

enable()

প্রতিশ্রুতি

chrome.action.enable(
  tabId?: number,
  callback?: function,
)

একটি ট্যাবের জন্য অ্যাকশন সক্রিয় করে। ডিফল্টরূপে, কর্ম সক্রিয় করা হয়.

পরামিতি

• ট্যাবআইডি

  সংখ্যা ঐচ্ছিক

  ট্যাবের আইডি যার জন্য আপনি অ্যাকশনটি পরিবর্তন করতে চান।

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  ()=>void

রিটার্নস

• প্রতিশ্রুতি <void>

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

getBadgeBackgroundColor()

প্রতিশ্রুতি

chrome.action.getBadgeBackgroundColor(
  details: TabDetails,
  callback?: function,
)

কর্মের পটভূমির রঙ পায়।

পরামিতি

• বিস্তারিত

  ট্যাব বিবরণ

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  (result: ColorArray)=>void

  • ফলাফল

    কালারঅ্যারে

রিটার্নস

• প্রতিশ্রুতি< browserAction.ColorArray >

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

getBadgeText()

প্রতিশ্রুতি

chrome.action.getBadgeText(
  details: TabDetails,
  callback?: function,
)

কর্মের ব্যাজ পাঠ্য পায়। যদি কোনো ট্যাব নির্দিষ্ট করা না থাকে, অ-ট্যাব-নির্দিষ্ট ব্যাজ টেক্সট ফেরত দেওয়া হয়। DisplayActionCountAsBadgeText সক্ষম করা থাকলে, declarativeNetRequestFeedback অনুমতি উপস্থিত না থাকলে বা ট্যাব-নির্দিষ্ট ব্যাজ টেক্সট দেওয়া না থাকলে একটি স্থানধারক পাঠ্য ফেরত দেওয়া হবে।

পরামিতি

• বিস্তারিত

  ট্যাব বিবরণ

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  (result: string)=>void

  • ফলাফল

    স্ট্রিং

রিটার্নস

• প্রতিশ্রুতি<string>

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

getBadgeTextColor()

প্রতিশ্রুতি Chrome 110+

chrome.action.getBadgeTextColor(
  details: TabDetails,
  callback?: function,
)

কর্মের পাঠ্য রঙ পায়।

পরামিতি

• বিস্তারিত

  ট্যাব বিবরণ

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  (result: ColorArray)=>void

  • ফলাফল

    কালারঅ্যারে

রিটার্নস

• প্রতিশ্রুতি< browserAction.ColorArray >

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

getPopup()

প্রতিশ্রুতি

chrome.action.getPopup(
  details: TabDetails,
  callback?: function,
)

এই ক্রিয়াকলাপের জন্য পপআপ হিসাবে html নথি সেট করে।

পরামিতি

• বিস্তারিত

  ট্যাব বিবরণ

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  (result: string)=>void

  • ফলাফল

    স্ট্রিং

রিটার্নস

• প্রতিশ্রুতি<string>

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

getTitle()

প্রতিশ্রুতি

chrome.action.getTitle(
  details: TabDetails,
  callback?: function,
)

কর্মের শিরোনাম পায়।

পরামিতি

• বিস্তারিত

  ট্যাব বিবরণ

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  (result: string)=>void

  • ফলাফল

    স্ট্রিং

রিটার্নস

• প্রতিশ্রুতি<string>

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

getUserSettings()

প্রতিশ্রুতি Chrome 91+

chrome.action.getUserSettings(
  callback?: function,
)

একটি এক্সটেনশনের ক্রিয়া সম্পর্কিত ব্যবহারকারী-নির্দিষ্ট সেটিংস প্রদান করে।

পরামিতি

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  (userSettings: UserSettings)=>void

  • ব্যবহারকারীর সেটিংস

    ব্যবহারকারীর সেটিংস

রিটার্নস

• প্রতিশ্রুতি< ব্যবহারকারী সেটিংস >

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

isEnabled()

প্রতিশ্রুতি Chrome 110+

chrome.action.isEnabled(
  tabId?: number,
  callback?: function,
)

কোনো ট্যাবের জন্য এক্সটেনশন অ্যাকশন সক্ষম করা হয়েছে কিনা তা নির্দেশ করে (বা বিশ্বব্যাপী যদি কোনো tabId দেওয়া না থাকে)। শুধুমাত্র declarativeContent ব্যবহার করে সক্রিয় করা কর্ম সর্বদা মিথ্যা ফেরত দেয়।

পরামিতি

• ট্যাবআইডি

  সংখ্যা ঐচ্ছিক

  ট্যাবের আইডি যার জন্য আপনি সক্রিয় স্থিতি পরীক্ষা করতে চান৷

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  (isEnabled: boolean)=>void

  • সক্রিয় করা হয়

    বুলিয়ান

    এক্সটেনশন অ্যাকশন সক্রিয় থাকলে সত্য।

রিটার্নস

• প্রতিশ্রুতি<বুলিয়ান>

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

openPopup()

প্রতিশ্রুতি Chrome 118+ এর জন্য নীতি প্রয়োজন

chrome.action.openPopup(
  options?: OpenPopupOptions,
  callback?: function,
)

এক্সটেনশনের পপআপ খোলে।

পরামিতি

• বিকল্প

  OpenPopupOptions ঐচ্ছিক

  পপআপ খোলার জন্য বিকল্পগুলি নির্দিষ্ট করে৷

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  ()=>void

রিটার্নস

• প্রতিশ্রুতি <void>

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

setBadgeBackgroundColor()

প্রতিশ্রুতি

chrome.action.setBadgeBackgroundColor(
  details: object,
  callback?: function,
)

ব্যাজের জন্য পটভূমির রঙ সেট করে।

পরামিতি

• বিস্তারিত

  বস্তু

  • রঙ

    স্ট্রিং| কালারঅ্যারে

    [0,255] পরিসরে চারটি পূর্ণসংখ্যার একটি অ্যারে যা ব্যাজের RGBA রঙ তৈরি করে। উদাহরণস্বরূপ, অস্বচ্ছ লাল হল [255, 0, 0, 255] । এছাড়াও একটি CSS মান সহ একটি স্ট্রিং হতে পারে, অস্বচ্ছ লাল #FF0000 বা #F00 ।

  • ট্যাবআইডি

    সংখ্যা ঐচ্ছিক

    যখন একটি নির্দিষ্ট ট্যাব নির্বাচন করা হয় তখন পরিবর্তন সীমিত করে। ট্যাব বন্ধ হয়ে গেলে স্বয়ংক্রিয়ভাবে রিসেট হয়।

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এরকম দেখাচ্ছে:

  ()=>void

রিটার্নস

• প্রতিশ্রুতি <void>

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

setBadgeText()

প্রতিশ্রুতি

chrome.action.setBadgeText(
  details: object,
  callback?: function,
)

কর্মের জন্য ব্যাজ পাঠ্য সেট করে। ব্যাজটি আইকনের উপরে প্রদর্শিত হয়।

পরামিতি

• বিস্তারিত

  বস্তু

  • ট্যাবআইডি

    সংখ্যা ঐচ্ছিক

    যখন একটি নির্দিষ্ট ট্যাব নির্বাচন করা হয় তখন পরিবর্তন সীমিত করে। ট্যাব বন্ধ হয়ে গেলে স্বয়ংক্রিয়ভাবে রিসেট হয়।

  • পাঠ্য

    স্ট্রিং ঐচ্ছিক

    যেকোন সংখ্যক অক্ষর পাস করা যেতে পারে, কিন্তু স্পেসে মাত্র চারটি ফিট হতে পারে। যদি একটি খালি স্ট্রিং ( '' ) পাস করা হয়, ব্যাজ পাঠ্যটি সাফ করা হয়। যদি tabId নির্দিষ্ট করা থাকে এবং text নাল থাকে, তাহলে নির্দিষ্ট ট্যাবের জন্য টেক্সট সাফ করা হয় এবং গ্লোবাল ব্যাজ টেক্সটে ডিফল্ট হয়।

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  ()=>void

রিটার্নস

• প্রতিশ্রুতি <void>

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

setBadgeTextColor()

প্রতিশ্রুতি Chrome 110+

chrome.action.setBadgeTextColor(
  details: object,
  callback?: function,
)

ব্যাজের জন্য পাঠ্যের রঙ সেট করে।

পরামিতি

• বিস্তারিত

  বস্তু

  • রঙ

    স্ট্রিং| কালারঅ্যারে

    [0,255] পরিসরে চারটি পূর্ণসংখ্যার একটি অ্যারে যা ব্যাজের RGBA রঙ তৈরি করে। উদাহরণস্বরূপ, অস্বচ্ছ লাল হল [255, 0, 0, 255] । এছাড়াও একটি CSS মান সহ একটি স্ট্রিং হতে পারে, অস্বচ্ছ লাল #FF0000 বা #F00 । এই মান সেট না করার ফলে একটি রঙ স্বয়ংক্রিয়ভাবে নির্বাচন করা হবে যা ব্যাজের পটভূমির রঙের সাথে বৈপরীত্য হবে যাতে পাঠ্যটি দৃশ্যমান হবে। 0 এর সমতুল্য আলফা মান সহ রঙগুলি সেট করা হবে না এবং একটি ত্রুটি ফিরিয়ে দেবে।

  • ট্যাবআইডি

    সংখ্যা ঐচ্ছিক

    যখন একটি নির্দিষ্ট ট্যাব নির্বাচন করা হয় তখন পরিবর্তন সীমিত করে। ট্যাব বন্ধ হয়ে গেলে স্বয়ংক্রিয়ভাবে রিসেট হয়।

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  ()=>void

রিটার্নস

• প্রতিশ্রুতি <void>

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

setIcon()

প্রতিশ্রুতি

chrome.action.setIcon(
  details: object,
  callback?: function,
)

কর্মের জন্য আইকন সেট করে। আইকনটিকে একটি ইমেজ ফাইলের পাথ হিসাবে বা একটি ক্যানভাস উপাদান থেকে পিক্সেল ডেটা হিসাবে বা যেকোন একটির অভিধান হিসাবে নির্দিষ্ট করা যেতে পারে। হয় পথ বা imageData বৈশিষ্ট্য নির্দিষ্ট করা আবশ্যক।

পরামিতি

• বিস্তারিত

  বস্তু

  • imageData

    ImageData|বস্তু ঐচ্ছিক

    হয় একটি ImageData অবজেক্ট বা একটি অভিধান {size -> ImageData} প্রতিনিধিত্বকারী আইকন সেট করতে হবে৷ যদি আইকনটি একটি অভিধান হিসাবে নির্দিষ্ট করা হয়, তাহলে পর্দার পিক্সেল ঘনত্বের উপর নির্ভর করে প্রকৃত চিত্রটি ব্যবহার করা হবে। যদি একটি স্ক্রীন স্পেস ইউনিটে ফিট করা ছবির পিক্সেলের সংখ্যা scale সমান হয়, তাহলে সাইজ scale * n সহ ছবি নির্বাচন করা হবে, যেখানে UI আইকনের আকার n। অন্তত একটি ছবি নির্দিষ্ট করা আবশ্যক। মনে রাখবেন যে 'details.imageData = foo' 'details.imageData = {'16': foo}' এর সমতুল্য।

  • পথ

    স্ট্রিং|অবজেক্ট ঐচ্ছিক

    হয় একটি আপেক্ষিক ইমেজ পাথ বা একটি অভিধান {size -> আপেক্ষিক ইমেজ পাথ} আইকন সেট করতে নির্দেশ করে৷ যদি আইকনটি একটি অভিধান হিসাবে নির্দিষ্ট করা হয়, তাহলে পর্দার পিক্সেল ঘনত্বের উপর নির্ভর করে প্রকৃত চিত্রটি ব্যবহার করা হবে। যদি একটি স্ক্রীন স্পেস ইউনিটে ফিট করা ছবির পিক্সেলের সংখ্যা scale সমান হয়, তাহলে সাইজ scale * n সহ ছবি নির্বাচন করা হবে, যেখানে UI আইকনের আকার n। অন্তত একটি ছবি নির্দিষ্ট করা আবশ্যক। মনে রাখবেন যে 'details.path = foo' 'details.path = {'16': foo}' এর সমতুল্য

  • ট্যাবআইডি

    সংখ্যা ঐচ্ছিক

    যখন একটি নির্দিষ্ট ট্যাব নির্বাচন করা হয় তখন পরিবর্তন সীমিত করে। ট্যাব বন্ধ হয়ে গেলে স্বয়ংক্রিয়ভাবে রিসেট হয়।

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  ()=>void

রিটার্নস

• প্রতিশ্রুতি <void>

  Chrome 96+

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

setPopup()

প্রতিশ্রুতি

chrome.action.setPopup(
  details: object,
  callback?: function,
)

ব্যবহারকারী যখন অ্যাকশনের আইকনে ক্লিক করে তখন HTML ডকুমেন্টকে পপআপ হিসেবে খোলার জন্য সেট করে।

পরামিতি

• বিস্তারিত

  বস্তু

  • পপআপ

    স্ট্রিং

    একটি পপআপে দেখানোর জন্য HTML ফাইলের আপেক্ষিক পথ। যদি খালি স্ট্রিং ( '' ) তে সেট করা হয় তবে কোনো পপআপ দেখানো হয় না।

  • ট্যাবআইডি

    সংখ্যা ঐচ্ছিক

    যখন একটি নির্দিষ্ট ট্যাব নির্বাচন করা হয় তখন পরিবর্তন সীমিত করে। ট্যাব বন্ধ হয়ে গেলে স্বয়ংক্রিয়ভাবে রিসেট হয়।

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  ()=>void

রিটার্নস

• প্রতিশ্রুতি <void>

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

setTitle()

প্রতিশ্রুতি

chrome.action.setTitle(
  details: object,
  callback?: function,
)

কর্মের শিরোনাম সেট করে। এটি টুলটিপে দেখায়।

পরামিতি

• বিস্তারিত

  বস্তু

  • ট্যাবআইডি

    সংখ্যা ঐচ্ছিক

    যখন একটি নির্দিষ্ট ট্যাব নির্বাচন করা হয় তখন পরিবর্তন সীমিত করে। ট্যাব বন্ধ হয়ে গেলে স্বয়ংক্রিয়ভাবে রিসেট হয়।

  • শিরোনাম

    স্ট্রিং

    স্ট্রিংটি মাউস ওভার করার সময় অ্যাকশনটি প্রদর্শন করা উচিত।

• কলব্যাক

  ফাংশন ঐচ্ছিক

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  ()=>void

রিটার্নস

• প্রতিশ্রুতি <void>

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

ঘটনা

onClicked

chrome.action.onClicked.addListener(
  callback: function,
)

একটি অ্যাকশন আইকন ক্লিক করা হলে বহিস্কার করা হয়। অ্যাকশনে পপআপ থাকলে এই ইভেন্টটি চালু হবে না।

পরামিতি

• কলব্যাক

  ফাংশন

  callback প্যারামিটারটি এর মত দেখাচ্ছে:

  (tab: tabs.Tab)=>void

  • ট্যাব

    tabs.Tab