menus.ContextType

Les différents contextes dans lesquels un élément de menu peut apparaître.

Type

Les valeurs de ce type sont des chaînes. L'élément est affiché lorsque le contexte donné s'applique. Les valeurs possibles sont :

all

La spécification de "tous" équivaut à la combinaison de tous les autres contextes, à l'exception de 'bookmark', 'tab' et 'tools_menu'.

audio

S'applique lorsque l'utilisateur clique sur le contexte d'un élément audio.

bookmark

S'applique lorsque l'utilisateur clique en contexte sur un élément de signet dans la barre d'outils des signets, le menu des signets, la barre latérale des signets (<kbd>Ctrl</kbd> + <kbd>B</kbd>) et la fenêtre Bibliothèque (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>B</kbd>). Ces deux derniers sont supportés à partir de Firefox 66. Nécessite la permission d'API dans le manifest.

browser_action

S'applique lorsque l'utilisateur clique en contexte sur l'action de votre navigateur. Le nombre maximal d'éléments pouvant être ajoutés au menu contextuel de l'action du navigateur de niveau supérieur est menus.ACTION_MENU_TOP_LEVEL_LIMIT, mais vous pouvez ajouter n'importe quel nombre d'éléments aux sous-menus.

editable

S'applique lorsque l'utilisateur clique en contexte sur un élément modifiable, comme un textarea.

frame

S'applique lorsque l'utilisateur clique sur le contexte dans une iframe imbriqué.

image

S'applique lorsque l'utilisateur clique sur le contexte d'une image.

S'applique lorsque l'utilisateur clique en contexte sur un lien.

page

S'applique lorsque l'utilisateur clique sur le contexte dans la page, mais aucun des autres contextes de page ne s'applique (par exemple, le clic ne se trouve pas sur une image ou une iframe imbriqué ou un lien).

page_action

S'applique lorsque l'utilisateur clique en contexte sur l'action de votre page. Le nombre maximal d'éléments pouvant être ajoutés au menu contextuel de l'action de page de niveau supérieur est menus.ACTION_MENU_TOP_LEVEL_LIMIT, mais vous pouvez ajouter n'importe quel nombre d'éléments aux sous-menus.

password

S'applique lorsque l'utilisateur clique en contexte sur un élément d'entrée de mot de passe.

selection

S'applique lorsqu'une partie de la page est sélectionnée.

tab

S'applique lorsque l'utilisateur clique en contexte sur un onglet (en particulier, il s'agit de l'onglet ou d'un autre élément de l'interface utilisateur permettant à l'utilisateur de passer d'un onglet de navigateur à un autre, et non à la page elle-même). Depuis Firefox 63, cliquer sur l'élément du menu d'un onglet accorde la permission activeTab pour l'onglet cliqué, même si ce n'est pas l'onglet actuellement actif.

tools_menu

L'élément sera ajouté au menu des outils du navigateur. Notez que ceci n'est disponible que si vous accédez à ContextType via l'espace de nom des menus. Il n'est pas disponible si vous y accédez via l'espace de noms contextMenus.

video

S'applique lorsque l'utilisateur clique sur le contexte d'un élément video.

Notez que "launcher" n'est pas supporté.

Compatibilité des navigateurs

BCD tables only load in the browser

Note :

Cette API est basée sur l'API chrome.contextMenus de chromium. Cette documentation est dérivée de context_menus.json dans le code Chromium.