aboutsummaryrefslogtreecommitdiff
path: root/files/fr/mozilla/add-ons/webextensions/api/menus/overridecontext/index.md
blob: 739b9acbd5369d492656e9c8ff12e68ba880cfe0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
---
title: overrideContext()
slug: Mozilla/Add-ons/WebExtensions/API/menus/overrideContext
tags:
  - API
  - Add-ons
  - Create
  - Extensions
  - Method
  - WebExtensions
  - contextMenus
translation_of: Mozilla/Add-ons/WebExtensions/API/menus/overrideContext
---
<p>{{AddonSidebar}}</p>

<p>Masquer tous les éléments de menu par défaut de Firefox en faveur d'un menu contextuel personnalisé.</p>

<p>La méthode overrideContext permet d'afficher les éléments de menu correspondants de cette extension à la place du menu par défaut. Cette méthode doit être appelée à partir d'un gestionnaire d'événements DOM 'contextmenu', et ne s'applique qu'au menu qui s'ouvre après cet événement.</p>

<p>Pour appeler cette méthode, votre extension doit avoir la permission <code>menus.overrideContext</code>.</p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="brush: js">browser.menus.overrideContext(
  contextOptions // object
)</pre>

<h3 id="Paramètres">Paramètres</h3>

<dl>
 <dt><code>contextOptions</code></dt>
 <dd><p><code>object</code>. Options sur la façon dont les menus contextuels seront remplacés.</p>
 <dl>
  <dt><code>showDefaults</code> {{optional_inline}}</dt>
  <dd><code>boolean</code>. S'il faut également inclure les éléments de menu par défaut dans le menu.</dd>
  <dt><code>context </code>{{optional_inline}}</dt>
  <dd><code>string</code>. Le ContextType à surcharger, pour autoriser les éléments de menu d'autres extensions dans le menu. Actuellement, seuls <code>'bookmark'</code> et <code>'tab'</code> sont supportés. <code>showDefaults</code> ne peut pas être utilisé avec cette option.</dd>
  <dt><code>bookmarkId </code>{{optional_inline}}</dt>
  <dd><code>string</code>. Requis lorsque le contexte est  <code>'bookmark'</code>. Nécessite la permission  'bookmark'.</dd>
  <dt><code>tabId </code>{{optional_inline}}</dt>
  <dd><code>integer</code>. Requis lorsque le contexte est <code>'tab'</code>. Nécessite la permission 'tabs'.</dd>
 </dl>
 </dd>
</dl>