menus.ContextType
Die verschiedenen Kontexte, in denen ein Menüelement erscheinen kann.
Typ
Werte dieses Typs sind Zeichenketten. Das Element wird angezeigt, wenn der angegebene 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 mit der rechten Maustaste auf Ihr Browser-Action-Element in einer Manifest-V3-Erweiterung klickt. Die maximale Anzahl von Elementen, die dem obersten Browser-Action-Kontextmenü 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 mit der rechten Maustaste auf ein audio-Element klickt.
- bookmark
-
Gilt, wenn der Benutzer mit der rechten Maustaste auf ein Lesezeichen-Element in der Lesezeichen-Symbolleiste, dem Lesezeichen-Menü, der Lesezeichen-Sidebar (Strg+B) und dem Bibliotheksfenster (Strg+Umschalt+B) klickt. Die letzten beiden werden seit Firefox 66 unterstützt. Erfordert die "bookmarks"-API-Genehmigung im Manifest.
- browser_action
-
Gilt, wenn der Benutzer mit der rechten Maustaste auf Ihr Browser-Action-Element in einer Manifest-V2-Erweiterung klickt. Die maximale Anzahl von Elementen, die dem obersten Browser-Action-Kontextmenü 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 mit der rechten Maustaste auf ein bearbeitbares Element klickt, wie z.B. ein textarea.
- frame
-
Gilt, wenn der Benutzer mit der rechten Maustaste in einem verschachtelten iframe klickt.
- image
-
Gilt, wenn der Benutzer mit der rechten Maustaste auf ein Bild klickt.
- link
-
Gilt, wenn der Benutzer mit der rechten Maustaste auf einen Link klickt.
- page
-
Gilt, wenn der Benutzer mit der rechten Maustaste auf die Seite klickt, aber keiner der anderen Seitenkontexte zutrifft (zum Beispiel der Klick erfolgt nicht auf ein Bild oder ein verschachteltes iframe oder einen Link).
- page_action
-
Gilt, wenn der Benutzer mit der rechten Maustaste auf Ihre Seiten-Aktion klickt. Die maximale Anzahl von Elementen, die dem obersten Seiten-Aktions-Kontextmenü 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 mit der rechten Maustaste auf ein Passwort-Eingabeelement klickt.
- selection
-
Gilt, wenn ein Teil der Seite ausgewählt ist.
- tab
-
Gilt, wenn der Benutzer mit der rechten Maustaste auf einen Tab klickt (dies bezieht sich speziell auf die Tab-Leiste oder anderes Benutzeroberflächenelement, das es dem Benutzer ermöglicht, zwischen den Browser-Tabs zu wechseln, nicht auf die Seite selbst).
Ab Firefox 63 gewährt das Klicken des Menüpunkts auf einem Tab die activeTab-Berechtigung für den angeklickten Tab, auch wenn dies nicht der aktuell aktive Tab ist.
-
Das Element wird dem Werkzeug-Menü 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 mit der rechten Maustaste auf ein video-Element klickt.
Beachten Sie, dass "launcher" nicht unterstützt wird.
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.contextMenus
-API von Chromium. Diese Dokumentation ist abgeleitet von context_menus.json
im Chromium-Code.