browserAction.onClicked
Wird ausgelöst, wenn ein Browser-Aktionssymbol angeklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Browser-Aktion ein Popup hat.
Um eine Aktion bei Rechtsklick zu definieren, verwenden Sie die contextMenus
API mit dem Kontexttyp "browser_action" context type.
Syntax
browser.browserAction.onClicked.addListener(listener)
browser.browserAction.onClicked.removeListener(listener)
browser.browserAction.onClicked.hasListener(listener)
Ereignisse haben drei Funktionen:
addListener(listener)
-
Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener)
-
Stoppt das Lauschen dieses Ereignisses. Das
listener
-Argument ist der zu entfernende Listener. hasListener(listener)
-
Überprüft, ob
listener
für dieses Ereignis registriert ist. Gibttrue
zurück, wenn er lauscht, sonstfalse
.
addListener Syntax
Parameter
listener
-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis auftritt. Der Funktion werden diese Argumente übergeben:
tab
-
tabs.Tab
. Der Tab, der aktiv war, als das Symbol angeklickt wurde. OnClickData
-
Ein Objekt, das Informationen über den Klick enthält.
modifiers
-
Ein
array
. Die zur Zeit des Klicks aktiven Tastatur-Modifikatoren, die eine oder mehrere der folgenden sein können:Shift
,Alt
,Command
,Ctrl
oderMacCtrl
. -
Ein
integer
. Gibt die verwendete Taste zum Klicken auf das Seitenaktionssymbol an:0
für einen Linksklick oder einen Klick, der nicht mit einer Maus verbunden ist, wie z.B. von der Tastatur, und1
für einen Klick mit der mittleren Taste oder dem Rad. Beachten Sie, dass der Rechtsklick nicht unterstützt wird, da Firefox diesen Klick verwendet, um das Kontextmenü anzuzeigen, bevor dieses Ereignis ausgelöst wird.
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Wenn der Benutzer auf das Browser-Aktionssymbol klickt, schaltet dieser Code es für den aktiven Tab aus und protokolliert die URL des Tabs:
browser.browserAction.onClicked.addListener((tab) => {
// disable the browser action for the tab
browser.browserAction.disable(tab.id);
// requires the "tabs" or "activeTab" permission, or host permissions for the URL
console.log(tab.url);
});
Beispiel-Erweiterungen
- bookmark-it
- favourite-colour
- find-across-tabs
- forget-it
- google-userinfo
- native-messaging
- open-my-page-button
- permissions
- runtime-examples
- store-collected-images
Hinweis: Diese API basiert auf der Chromium-API chrome.browserAction
. Diese Dokumentation basiert auf browser_action.json
im Chromium-Code.