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
listenerist der zu entfernende Listener. hasListener(listener)-
Überprüft, ob ein
listenerfür dieses Ereignis registriert ist. Gibttruezurück, wenn es aktiv ist,falseandernfalls.
addListener Syntax
>Parameter
listener-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion werden folgende Argumente übergeben:
tab-
Ein
tabs.TabObjekt, 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,CtrloderMacCtrl. -
Ein
integer. Zeigt die Taste an, mit der das Page-Action-Symbol angeklickt wurde:0für einen Linksklick oder einen Klick, der nicht mit einer Maus verbunden ist, wie z. B. einer von der Tastatur, und1fü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.