Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

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 Argument listener ist der zu entfernende Listener.

hasListener(listener)

Überprüft, ob ein listener für dieses Ereignis registriert ist. Gibt true zurück, wenn es zuhört, andernfalls false.

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, Ctrl oder MacCtrl.

button

Ein Integer. Gibt die Schaltfläche an, die zum Klicken auf das Seitenaktionssymbol verwendet wurde: 0 für einen Linksklick oder einen Klick, der nicht mit einer Maus verbunden ist, wie z.B. einer von der Tastatur, und 1 fü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:

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

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.