action.onClicked
Wird ausgelöst, wenn ein Browser-Aktionssymbol angeklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Browser-Aktion ein Popup hat.
Hinweis: Diese API ist in Manifest V3 oder höher verfügbar.
Um eine Rechtsklick-Aktion zu definieren, verwenden Sie die contextMenus
API mit dem "browser_action" Kontexttyp.
Syntax
browser.action.onClicked.addListener(listener)
browser.action.onClicked.removeListener(listener)
browser.action.onClicked.hasListener(listener)
Ereignisse haben drei Funktionen:
addListener(listener)
-
Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener)
-
Hört auf, dieses Ereignis zu überwachen. Das Argument
listener
ist der Listener, der entfernt werden soll. 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 auftritt. Der Funktion werden folgende Argumente übergeben:
tab
-
tabs.Tab
. Der Tab, der aktiv war, als das Symbol angeklickt wurde. OnClickData
-
Ein Objekt mit Informationen über den Klick.
modifiers
-
Ein
array
. Die Tastaturmodifikatoren, die zum Zeitpunkt des Klicks aktiv waren, wobei es sich um einen oder mehrere vonShift
,Alt
,Command
,Ctrl
oderMacCtrl
handeln kann. -
Ein
integer
. Gibt die Taste an, mit der das Seitensymbol angeklickt 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 eine mittlere Taste oder einen Mausradklick. Beachten Sie, dass der Rechtsklick nicht unterstützt wird, da Firefox diesen Klick verwendet, um das Kontextmenü anzuzeigen, bevor dieses Ereignis ausgelöst wird.
Beispiele
Wenn der Benutzer auf das Symbol klickt, deaktivieren Sie es für den aktiven Tab und protokollieren Sie die URL des Tabs:
browser.action.onClicked.addListener((tab) => {
// disable the active tab
browser.action.disable(tab.id);
// requires the "tabs" or "activeTab" permission, or host permissions for the URL
console.log(tab.url);
});
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf Chromiums chrome.action
API. Diese Dokumentation ist abgeleitet von browser_action.json
im Chromium-Code.