menus.ContextType
Die verschiedenen Kontexte, in denen ein Menüelement angezeigt werden kann.
Typ
Werte dieses Typs sind Strings. Das Element wird angezeigt, wenn der angegebene Kontext zutrifft. Mögliche Werte sind:
- all
-
Die Angabe von 'all' entspricht der Kombination aller anderen Kontexte, mit Ausnahme von 'bookmark', 'tab' und 'tools_menu'.
- action
-
Gilt, wenn der Benutzer in einer Manifest V3-Erweiterung auf Ihre Browser-Aktion einen Rechtsklick ausführt. Die maximale Anzahl von Elementen, die zum obersten Browser-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. - audio
-
Gilt, wenn der Benutzer auf ein audio Element einen Rechtsklick ausführt.
- bookmark
-
Gilt, wenn der Benutzer auf ein Lesezeichen-Element in der Lesezeichen-Symbolleiste, dem Lesezeichen-Menü, der Lesezeichen-Seitenleiste (Ctrl+B) und dem Bibliotheksfenster (Ctrl+Shift+B) einen Rechtsklick ausführt. Die letzten beiden werden seit Firefox 66 unterstützt. Erfordert die "bookmarks" API-Berechtigung im Manifest.
- browser_action
-
Gilt, wenn der Benutzer in einer Manifest V2-Erweiterung auf Ihre Browser-Aktion einen Rechtsklick ausführt. Die maximale Anzahl von Elementen, die zum obersten Browser-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. - editable
-
Gilt, wenn der Benutzer auf ein bearbeitbares Element wie ein textarea einen Rechtsklick ausführt.
- frame
-
Gilt, wenn der Benutzer in einem verschachtelten iframe einen Rechtsklick ausführt.
- image
-
Gilt, wenn der Benutzer auf ein Bild einen Rechtsklick ausführt.
- link
-
Gilt, wenn der Benutzer auf einen Link einen Rechtsklick ausführt.
- page
-
Gilt, wenn der Benutzer auf der Seite einen Rechtsklick ausführt, aber keiner der anderen Seitenkontexte zutrifft (zum Beispiel befindet sich der Klick nicht auf einem Bild, einem verschachtelten iframe oder einem Link).
- page_action
-
Gilt, wenn der Benutzer auf Ihre Seitenaktion einen Rechtsklick ausführt. Die maximale Anzahl von Elementen, die zum obersten Seitenaktions-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 auf ein Passwort-Eingabeelement einen Rechtsklick ausführt.
- selection
-
Gilt, wenn ein Teil der Seite ausgewählt ist.
- tab
-
Gilt, wenn der Benutzer auf einen Tab einen Rechtsklick ausführt (dies bezieht sich speziell auf die Tab-Leiste oder ein anderes Benutzeroberflächenelement, das es dem Benutzer ermöglicht, von einem Browser-Tab zu einem anderen zu wechseln, nicht auf die Seite selbst).
Ab Firefox 63 gewährt das Klicken auf das Menüelement in einem Tab die activeTab Berechtigung für den angeklickten Tab, auch wenn dieser nicht der aktuell aktive Tab ist.
-
Das Element wird zum Werkzeug-Menü des Browsers hinzugefügt. Beachten Sie, dass dies nur verfügbar ist, wenn Sie
ContextType
über denmenus
-Namespace aufrufen. Es ist nicht verfügbar, wenn Sie es über dencontextMenus
-Namespace aufrufen. - video
-
Gilt, wenn der Benutzer auf ein video Element einen Rechtsklick ausführt.
Beachten Sie, dass "launcher" nicht unterstützt wird.
Browser-Kompatibilität
BCD tables only load in the browser
Hinweis:
Diese API basiert auf der chrome.contextMenus
API von Chromium. Diese Dokumentation wird aus context_menus.json
im Chromium-Code abgeleitet.