browserAction.onClicked
Wird ausgelöst, wenn ein Symbol einer Browser-Aktion angeklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Browser-Aktion ein Popup hat.
Um eine Aktion für einen Rechtsklick 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)
-
Beendet das Zuhören für dieses Ereignis. 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 zuhört, andernfallsfalse
.
addListener Syntax
Parameter
listener
-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion werden folgende 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 zum Zeitpunkt des Klicks aktiven Tastatur-Modifikatoren sind eines oder mehrere vonShift
,Alt
,Command
,Ctrl
oderMacCtrl
. -
Ein
integer
. Zeigt die Schaltfläche an, die verwendet wurde, um auf das Seitensymbol zu klicken:0
für einen Linksklick oder einen Klick, der nicht mit einer Maus verbunden ist, wie z.B. einer von der Tastatur, und1
für einen Klick mit der mittleren Schaltfläche 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.
Beispiele
Wenn der Benutzer auf das Symbol der Browser-Aktion 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);
});
Beispielerweiterungen
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.browserAction
API von Chromium. Diese Dokumentation ist abgeleitet von browser_action.json
im Chromium-Code.