browserAction.onClicked
Wird ausgelöst, wenn ein Browseraktionssymbol angeklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Browseraktion ein Popup hat.
Um eine Rechtsklickaktion zu definieren, verwenden Sie die contextMenus
API mit dem "browser_action" Kontexttyp.
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 Argument
listener
ist der zu entfernende Listener. hasListener(listener)
-
Überprüft, ob
listener
für dieses Ereignis registriert ist. Gibttrue
zurück, wenn es lauscht, andernfallsfalse
.
addListener-Syntax
Parameter
listener
-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Die Funktion erhält diese Argumente:
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 Tastaturmodifikatoren, die zum Zeitpunkt des Klicks aktiv waren, eines oder mehrere vonShift
,Alt
,Command
,Ctrl
oderMacCtrl
. -
Ein
integer
. Gibt die Schaltfläche an, die zum Anklicken des Seitenaktionssymbols verwendet wurde:0
für einen Linksklick oder einen Klick, der nicht mit einer Maus verbunden ist, wie zum Beispiel einer 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 konsumiert, um das Kontextmenü anzuzeigen, bevor dieses Ereignis ausgelöst wird.
Browser-Kompatibilität
Beispiele
Wenn der Benutzer auf das Symbol der Browseraktion klickt, schaltet dieser Code die Aktion für den aktiven Tab ab 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);
});
Beispielerweiterungen
- 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 chrome.browserAction
API von Chromium. Diese Dokumentation basiert auf browser_action.json
im Chromium-Code.