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

js
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. Gibt true zurück, wenn es lauscht, andernfalls false.

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 aus Shift, Alt, Command, Ctrl oder MacCtrl.

button

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, und 1 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:

js
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.