pageAction.onClicked
Wird ausgelöst, wenn ein Page-Action-Icon angeklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Page-Action ein Popup hat.
Um eine Rechtsklick-Aktion zu definieren, verwenden Sie die contextMenus
API mit dem "page_action" context type#.
Syntax
browser.pageAction.onClicked.addListener(listener)
browser.pageAction.onClicked.removeListener(listener)
browser.pageAction.onClicked.hasListener(listener)
Ereignisse haben drei Funktionen:
addListener(listener)
-
Fügt einen Listener für dieses Ereignis hinzu.
removeListener(listener)
-
Hört auf, auf dieses Ereignis zu hören. Das
listener
Argument ist der zu entfernende Listener. hasListener(listener)
-
Überprüft, ob ein
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
-
Ein
tabs.Tab
Objekt, das den Tab repräsentiert, dessen Page-Action angeklickt wurde. OnClickData
-
Ein Objekt, das Informationen über den Klick enthält.
modifiers
-
Ein
array
. Die zum Zeitpunkt des Klicks aktiven Tastaturmodifikatoren, bestehend aus einem oder mehreren vonShift
,Alt
,Command
,Ctrl
oderMacCtrl
. -
Ein
integer
. Zeigt den Button an, der zum Klicken des Page-Action-Icons verwendet wurde:0
für einen Linksklick oder einen Klick, der nicht mit einer Maus verbunden ist, wie einer von der Tastatur, und1
für einen Mittelklick oder ein Drehradbefehl. Beachten Sie, dass der Rechtsklick nicht unterstützt wird, da Firefox diesen Klick nutzt, 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 die Page-Action klickt, verstecken Sie sie und navigieren Sie den aktiven Tab zu "https://giphy.com/explore/cat":
let catGifs = "https://giphy.com/explore/cat";
browser.pageAction.onClicked.addListener((tab) => {
browser.pageAction.hide(tab.id);
browser.tabs.update({ url: catGifs });
});
browser.pageAction.onClicked.addListener(() => {});
Beispielerweiterungen
Hinweis:
Diese API basiert auf der chrome.pageAction
API von Chromium. Diese Dokumentation stammt aus page_action.json
im Chromium-Code.