menus.ContextType
Die verschiedenen Kontexte, in denen ein Menüelement erscheinen kann.
Typ
Werte dieses Typs sind Zeichenfolgen. 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 auf Ihre Browser-Aktion in einer Manifest V3-Erweiterung mit der rechten Maustaste klickt. Die maximale Anzahl von Elementen, die dem obersten Browser-Aktionskontextmenü hinzugefügt werden können, beträgt
menus.ACTION_MENU_TOP_LEVEL_LIMIT
, aber Sie können beliebig viele Elemente in Untermenüs hinzufügen. - audio
-
Gilt, wenn der Benutzer auf ein audio-Element mit der rechten Maustaste klickt.
- bookmark
-
Gilt, wenn der Benutzer auf ein Lesezeichen-Element in der Lesezeichen-Symbolleiste, im Lesezeichen-Menü, in der Lesezeichen-Seitenleiste (Strg+B) und im Bibliotheks-Fenster (Strg+Umschalt+B) mit der rechten Maustaste klickt. Letztere zwei werden ab Firefox 66 unterstützt. Erfordert die "bookmarks" API-Berechtigung im Manifest.
- browser_action
-
Gilt, wenn der Benutzer auf Ihre Browser-Aktion in einer Manifest V2-Erweiterung mit der rechten Maustaste klickt. Die maximale Anzahl von Elementen, die dem obersten Browser-Aktionskontextmenü hinzugefügt werden können, beträgt
menus.ACTION_MENU_TOP_LEVEL_LIMIT
, aber Sie können beliebig viele Elemente in Untermenüs hinzufügen. - editable
-
Gilt, wenn der Benutzer auf ein editierbares Element, wie ein textarea, mit der rechten Maustaste klickt.
- frame
-
Gilt, wenn der Benutzer in einem verschachtelten iframe mit der rechten Maustaste klickt.
- image
-
Gilt, wenn der Benutzer auf ein Bild mit der rechten Maustaste klickt.
- link
-
Gilt, wenn der Benutzer auf einen Link mit der rechten Maustaste klickt.
- page
-
Gilt, wenn der Benutzer auf der Seite mit der rechten Maustaste klickt, aber keiner der anderen Seitenkontexte zutrifft (zum Beispiel ist der Klick nicht auf ein Bild oder ein verschachteltes iframe oder einen Link).
- page_action
-
Gilt, wenn der Benutzer auf Ihre Page-Aktion mit der rechten Maustaste klickt. Die maximale Anzahl von Elementen, die dem obersten Page-Aktion-Kontextmenü hinzugefügt werden können, beträgt
menus.ACTION_MENU_TOP_LEVEL_LIMIT
, aber Sie können beliebig viele Elemente in Untermenüs hinzufügen. - password
-
Gilt, wenn der Benutzer auf ein Passworteingabe-Element mit der rechten Maustaste klickt.
- selection
-
Gilt, wenn ein Teil der Seite ausgewählt ist.
- tab
-
Gilt, wenn der Benutzer auf einen Tab mit der rechten Maustaste klickt (dies bezieht sich auf die Tab-Leiste oder ein anderes Benutzeroberflächen-Element, das dem Benutzer das Wechseln von einem Browser-Tab zu einem anderen ermöglicht, nicht auf die Seite selbst).
Ab Firefox 63 berechtigt das Klicken auf das Menüelement auf einem Tab zur activeTab-Berechtigung für den geklickten Tab, selbst wenn dieser nicht der aktuell aktive Tab ist.
-
Das Element wird dem Werkzeuge-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 auf ein video-Element mit der rechten Maustaste 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 stammt aus context_menus.json
im Chromium-Code.