pageAction.onClicked
Wird ausgelöst, wenn auf ein Seitenaktionssymbol geklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Seitenaktion ein Popup hat.
Um eine Rechtsklick-Aktion zu definieren, verwenden Sie die menus 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 Argument
listenerist der zu entfernende Listener. hasListener(listener)-
Überprüft, ob ein
listenerfür dieses Ereignis registriert ist. Gibttruezurü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 darstellt, dessen Seitenaktion angeklickt wurde. OnClickData-
Ein Objekt, das Informationen über den Klick enthält.
modifiers-
Ein
Array. Die Tastaturmodifikatoren, die zum Zeitpunkt des Klicks aktiv waren, bestehend aus einem oder mehreren der folgenden:Shift,Alt,Command,CtrloderMacCtrl. -
Ein
Integer. Gibt die Schaltfläche an, die zum Klicken auf das Seitenaktionssymbol verwendet 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 Mittelklick 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 die Seitenaktion klickt, wird sie ausgeblendet und der aktive Tab wird 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
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromium's chrome.pageAction API. Diese Dokumentation leitet sich von page_action.json im Chromium-Code ab.