कोई कार्रवाई लागू करें

जब कोई उपयोगकर्ता टूलबार के आइकॉन पर क्लिक करता है, तो उसे एक ऐक्शन कहा जाता है. आम तौर पर, इसे आपके एक्सटेंशन के लिए ऐक्शन आइकॉन कहा जाता है. ऐक्शन ऐक्शन एपीआई का इस्तेमाल करके, एक्सटेंशन की सुविधा को चालू करता है या पॉप-अप खोलता है. इस पेज पर, एक्सटेंशन की किसी सुविधा को चालू करने का तरीका बताया गया है. पॉप-अप का इस्तेमाल करने के लिए, पॉप-अप जोड़ना लेख पढ़ें.

ऐक्शन रजिस्टर करना

chrome.action एपीआई का इस्तेमाल करने के लिए, एक्सटेंशन की मेनिफ़ेस्ट फ़ाइल में "action" कुंजी जोड़ें. इस फ़ील्ड की ज़रूरी नहीं वाली प्रॉपर्टी के बारे में पूरी जानकारी पाने के लिए, मेनिफ़ेस्ट सेक्शन के chrome.action एपीआई रेफ़रंस का मेनिफ़ेस्ट सेक्शन देखें.

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}`});
});

शर्त के हिसाब से ऐक्शन चालू करना

The chrome.declarativeContent API की मदद से, पेज के यूआरएल के आधार पर या पेज पर मौजूद एलिमेंट से सीएसएस सिलेक्टर मैच होने पर, एक्सटेंशन का ऐक्शन आइकॉन चालू किया जा सकता है. जब किसी एक्सटेंशन का ऐक्शन आइकॉन बंद होता है, तो वह आइकॉन धुंधला दिखता है. अगर उपयोगकर्ता बंद किए गए आइकॉन पर क्लिक करता है, तो एक्सटेंशन का कॉन्टेक्स्ट मेन्यू दिखता है.

ऐक्शन बैज

बैज, फ़ॉर्मैट किया गया टेक्स्ट होता है. इसे ऐक्शन आइकॉन के ऊपर रखा जाता है. इससे एक्सटेंशन की स्थिति या उपयोगकर्ता के लिए ज़रूरी कार्रवाइयों जैसी चीज़ों के बारे में पता चलता है. इसे दिखाने के लिए, ड्रिंक वॉटर सैंपल में "चालू" वाला बैज दिखता है. इससे उपयोगकर्ता को पता चलता है कि उसने अलार्म सेट कर लिया है. वहीं, जब एक्सटेंशन इस्तेमाल में नहीं होता, तो कोई बैज नहीं दिखता. बैज में ज़्यादा से ज़्यादा चार वर्ण हो सकते हैं.

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() को कॉल करके भी टूलटिप सेट या अपडेट कर सकते हैं. अगर कोई टूलटिप सेट नहीं किया जाता है, तो एक्सटेंशन का नाम दिखता है.