menus.onClicked
Wird ausgelöst, wenn ein Menüeintrag angeklickt wird.
Zur Kompatibilität mit anderen Browsern stellt Firefox dieses Ereignis sowohl über den contextMenus
-Namespace als auch über den menus
-Namespace zur Verfügung.
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)
-
Stoppt das Lauschen auf dieses Ereignis. Das Argument
listener
ist der zu entfernende Listener. hasListener(listener)
-
Überprüft, ob
listener
für dieses Ereignis registriert ist. Gibttrue
zurück, wenn es lauscht, andernfallsfalse
.
addListener-Syntax
Parameter
listener
-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis auftritt. Der Funktion werden folgende Argumente übergeben:
info
-
menus.OnClickData
. Informationen über das angeklickte Element und den Kontext, in dem der Klick stattfand. tab
-
tabs.Tab
. Die Details des Tabs, in dem der Klick stattfand. Falls der Klick nicht in oder auf einem Tab stattfand, fehlt dieser Parameter.
Browser-Kompatibilität
Beispiele
Dieses Beispiel hört auf Klicks auf einen Menüeintrag und protokolliert dann die ID des Elements 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
Hinweis:
Diese API basiert auf der chrome.contextMenus
-API von Chromium. Diese Dokumentation ist abgeleitet von context_menus.json
im Chromium-Code.