pageAction.onClicked
Wird ausgelöst, wenn auf ein Page-Action-Symbol geklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Page-Action ein Popup hat.
Um eine Aktion bei einem Rechtsklick 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 diesem Ereignis einen Listener hinzu.
removeListener(listener)
-
Beendet das Lauschen auf dieses Ereignis. 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 lauscht, andernfallsfalse
.
Syntax von addListener
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, eine oder mehrere ausShift
,Alt
,Command
,Ctrl
oderMacCtrl
. -
Ein
integer
. Gibt die Schaltfläche an, die verwendet wurde, um auf das Page-Action-Symbol zu klicken: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 mittleren Schaltflächen- oder Radklick. 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
Beispiele
Wenn der Benutzer auf die Page-Action klickt, wird diese ausgeblendet und der aktive Tab auf "https://giphy.com/explore/cat" navigiert:
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 leitet sich von page_action.json
im Chromium-Code ab.