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

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

कार्रवाई को रजिस्टर करें

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

manifest.json:

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

कार्रवाई का जवाब दें

जब उपयोगकर्ता कार्रवाई आइकॉन पर क्लिक करे, तो उसके लिए एक onClicked हैंडलर रजिस्टर करें. अगर मेनिफ़ेस्ट.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 की मदद से, एक्सटेंशन के ऐक्शन आइकॉन को चालू किया जा सकता है. यह आइकॉन, पेज के यूआरएल या सीएसएस सिलेक्टर से पेज पर मौजूद एलिमेंट को मैच करने पर होता है. जब किसी एक्सटेंशन का कार्रवाई आइकॉन बंद होता है, तो आइकॉन धूसर हो जाता है. अगर उपयोगकर्ता बंद किए गए आइकॉन पर क्लिक करता है, तो एक्सटेंशन का संदर्भ मेन्यू दिखता है.

ऐक्शन बैज

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

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