pageAction.onClicked
Wird ausgelöst, wenn ein Page-Action-Symbol angeklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Seitenaktion 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 diesem Ereignis einen Listener hinzu.
removeListener(listener)
-
Beenden Sie die Überwachung dieses Ereignisses. Das Argument
listener
ist der zu entfernende Listener. hasListener(listener)
-
Überprüft, ob ein
listener
für dieses Ereignis registriert ist. Gibttrue
zurück, wenn es aktiv ist,false
andernfalls.
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 Tastaturmodifikatoren, die zum Zeitpunkt des Klicks aktiv sind, eine oder mehrere vonShift
,Alt
,Command
,Ctrl
oderMacCtrl
. -
Ein
integer
. Zeigt die Taste an, mit der das Page-Action-Symbol angeklickt wurde: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 mittleren Knopf oder Radklick. Beachten Sie, dass der Rechtsklick nicht unterstützt wird, da Firefox diesen Klick nutzt, um das Kontextmenü anzuzeigen, bevor dieses Ereignis ausgelöst wird.
Beispiele
Wenn der Benutzer auf die Seitenaktion klickt, blenden Sie sie aus 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
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf Chromium's chrome.pageAction
API. Diese Dokumentation ist abgeleitet von page_action.json
im Chromium-Code.