menus.ContextType
Die verschiedenen Kontexte, in denen ein Menüelement erscheinen kann.
Typ
Werte dieses Typs sind Zeichenketten. Das Element wird angezeigt, wenn der gegebene Kontext zutrifft. Mögliche Werte sind:
- all
-
Die Angabe von 'all' entspricht der Kombination aller anderen Kontexte außer 'bookmark', 'tab' und 'tools_menu'.
- action
-
Gilt, wenn der Benutzer in einem Manifest V3-Add-on auf Ihre Browser-Aktion rechtsklickt. Die maximale Anzahl von Elementen, die dem obersten Kontextmenü der Browser-Aktion hinzugefügt werden können, ist
menus.ACTION_MENU_TOP_LEVEL_LIMIT
, aber Sie können beliebig viele Elemente zu Untermenüs hinzufügen. - audio
-
Gilt, wenn der Benutzer auf ein audio-Element rechtsklickt.
- bookmark
-
Gilt, wenn der Benutzer auf ein Lesezeichen in der Lesezeichen-Symbolleiste, im Lesezeichen-Menü, in der Lesezeichen-Sidebar (Strg+B) und im Bibliotheksfenster (Strg+Umschalt+B) rechtsklickt. Die letzten beiden werden seit Firefox 66 unterstützt. Erfordert die "bookmarks"-API-Berechtigung im Manifest.
- browser_action
-
Gilt, wenn der Benutzer in einem Manifest V2-Add-on auf Ihre Browser-Aktion rechtsklickt. Die maximale Anzahl von Elementen, die dem obersten Kontextmenü der Browser-Aktion hinzugefügt werden können, ist
menus.ACTION_MENU_TOP_LEVEL_LIMIT
, aber Sie können beliebig viele Elemente zu Untermenüs hinzufügen. - editable
-
Gilt, wenn der Benutzer auf ein bearbeitbares Element, wie ein textarea, rechtsklickt.
- frame
-
Gilt, wenn der Benutzer in einem verschachtelten iframe rechtsklickt.
- image
-
Gilt, wenn der Benutzer auf ein Bild rechtsklickt.
- link
-
Gilt, wenn der Benutzer auf einen Link rechtsklickt.
- page
-
Gilt, wenn der Benutzer auf die Seite rechtsklickt, aber keiner der anderen Seitenkontexte zutrifft (zum Beispiel der Klick ist nicht auf einem Bild, einem verschachtelten iframe oder einem Link).
- page_action
-
Gilt, wenn der Benutzer auf Ihre Seitenauswahl rechtsklickt. Die maximale Anzahl von Elementen, die dem obersten Kontextmenü der Seitenauswahl hinzugefügt werden können, ist
menus.ACTION_MENU_TOP_LEVEL_LIMIT
, aber Sie können beliebig viele Elemente zu Untermenüs hinzufügen. - password
-
Gilt, wenn der Benutzer auf ein Passworteingabefeld rechtsklickt.
- selection
-
Gilt, wenn ein Teil der Seite ausgewählt ist.
- tab
-
Gilt, wenn der Benutzer auf einen Tab rechtsklickt (spezifisch bezieht sich dies auf die Tab-Leiste oder ein anderes Benutzeroberflächenelement, das dem Benutzer ermöglicht, von einem Browser-Tab zum anderen zu wechseln, nicht auf die Seite selbst).
Ab Firefox 63 erteilt das Klicken auf das Menüelement auf einem Tab die activeTab-Berechtigung für den angeklickten Tab, auch wenn dieser nicht der derzeit aktive Tab ist.
-
Das Element wird dem Werkzeugmenü des Browsers hinzugefügt. Beachten Sie, dass dies nur verfügbar ist, wenn Sie
ContextType
über denmenus
-Namensraum aufrufen. Es ist nicht verfügbar, wenn Sie es über dencontextMenus
-Namensraum aufrufen. - video
-
Gilt, wenn der Benutzer auf ein video-Element rechtsklickt.
Beachten Sie, dass "launcher" nicht unterstützt wird.
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromiums chrome.contextMenus
API. Diese Dokumentation ist abgeleitet von context_menus.json
im Chromium-Code.