menus.onClicked

Wird ausgelöst, wenn auf einen Menüeintrag geklickt wird.

Aus Gründen der Kompatibilität mit anderen Browsern stellt Firefox dieses Ereignis sowohl über den Namespace contextMenus als auch über den Namespace menus bereit.

Wenn die Erweiterung über die activeTab-Berechtigung verfügt, ist die Auswahl eines Menüeintrags eine Benutzeraktion, die ihr vorübergehend Zugriff auf den Tab gewährt, in dem der Klick erfolgte.

Syntax

browser.menus.onClicked.addListener(listener)
browser.menus.onClicked.removeListener(listener)
browser.menus.onClicked.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener): Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener): Beendet das Abhören dieses Ereignisses. Das Argument listener gibt den zu entfernenden Listener an.
hasListener(listener): Prüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn dies der Fall ist, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Ihr werden folgende Argumente übergeben:

info: menus.OnClickData. Informationen über den angeklickten Eintrag und den Kontext, in dem der Klick erfolgte.
tab: tabs.Tab. Details zu dem Tab, in dem der Klick erfolgte. Wenn der Klick nicht in oder auf einem Tab erfolgte, fehlt dieser Parameter.

Beispiele

Dieses Beispiel wartet auf Klicks auf einen Menüeintrag und protokolliert anschließend die ID des Eintrags und die Tab-ID:

browser.menus.create({
  id: "click-me",
  title: "Click me!",
  contexts: ["all"],
});

browser.menus.onClicked.addListener((info, tab) => {
  console.log(`Item ${info.menuItemId} clicked in tab ${tab.id}`);
});

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf Chromiums API chrome.contextMenus. Diese Dokumentation wurde aus context_menus.json im Chromium-Code abgeleitet.

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden