कार्रवाई तब होती है, जब उपयोगकर्ता टूलबार आइकॉन पर क्लिक करता है. आम तौर पर, इसे आपके एक्सटेंशन का ऐक्शन आइकॉन कहा जाता है. कोई कार्रवाई, ऐक्शन एपीआई का इस्तेमाल करके एक्सटेंशन सुविधा को चालू करती है या पॉप-अप खोलता है. इस ��ेज में बताया गया है कि किसी एक्सटेंशन सुविधा को कैसे शुरू करें. पॉप-अप का इस्तेमाल करने के लिए, पॉप-अप जोड़ें वाला लेख देखें.
कार्रवाई रजिस्टर करें
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}`});
});
कार्रवाई को शर्तों के साथ चालू करें
chrome.declarativeContent
एपीआई की मदद से, एक्सटेंशन के ऐक्शन आइकॉन को पेज के यूआरएल या सीएसएस सिलेक्टर, पेज पर मौजूद एलिमेंट से मैच होने के आधार पर चालू किया जा सकता है. जब किसी एक्सटेंशन का कार्रवाई आइकॉन बंद होता है, तो आइकॉन धूसर हो जाता है. अगर उपयोगकर्ता 'बंद है' आइकॉन पर क्लिक करता है, तो एक्सटेंशन का संदर्भ मेन्यू दिखता है.
कार्रवाई बैज
बैज, फ़ॉर्मैट किए गए टेक्स्ट के ऐसे हिस्से होते हैं जिन्हें कार्रवाई आइकॉन के सबसे ऊपर रखा जाता है. इससे, एक्सटेंशन की स्थिति या उपयोगकर्ता की ��ार्रवाइयों को दिखाने के बारे में पता चलता है. इसे दिखाने के लिए, पानी पीने का सैंपल, "चालू है" के साथ एक बैज दिखाता है. इससे, उपयोगकर्ता को पता चलता है कि उन्होंने अलार्म सेट कर दिया है. एक्सटेंशन इस्तेमाल न होने पर कुछ नहीं दिखाता है. बैज में ज़्यादा से ज़्यादा चार वर्ण हो सकते हैं.
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()
` पर कॉल करके भी, टूलटिप को सेट या अपडेट किया जा सकता है. अगर कोई टूलटिप सेट नहीं है, तो एक्सटेंशन का नाम दिखता है.