diff options
Diffstat (limited to 'files/fr/mozilla/add-ons/webextensions/api/menus')
16 files changed, 85 insertions, 89 deletions
diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/action_menu_top_level_limit/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/action_menu_top_level_limit/index.html index e6bf0f03be..29765ce11e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/action_menu_top_level_limit/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/action_menu_top_level_limit/index.html @@ -27,7 +27,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/ACTION_MENU_TOP_LEVEL_LI <p>{{WebExtExamples}}</p> -<div class="note"><strong>Remerciements</strong> +<div class="note"><p><strong>Note :</strong></p> <p>Cette API est basée sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> </div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/contexttype/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/contexttype/index.html index 3bca3f1d69..9f8c8c824c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/contexttype/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/contexttype/index.html @@ -48,8 +48,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/ContextType <dt>selection</dt> <dd>S'applique lorsqu'une partie de la page est sélectionnée.</dd> <dt>tab</dt> - <dd>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).</dd> - <dd>Depuis Firefox 63, cliquer sur l'élément du menu d'un onglet accorde la permission <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#activeTab_permission">activeTab</a> pour l'onglet cliqué, même si ce n'est pas l'onglet actuellement actif.</dd> + <dd>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 <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#activeTab_permission">activeTab</a> pour l'onglet cliqué, même si ce n'est pas l'onglet actuellement actif.</dd> <dt>tools_menu</dt> <dd>L'élément sera ajouté au menu des outils du navigateur. Notez que ceci n'est disponible que si vous accédez à <code>ContextType</code> via l'espace de nom des <code>menus</code>. Il n'est pas disponible si vous y accédez via l'espace de noms <code>contextMenus</code>.</dd> <dt>video</dt> @@ -64,7 +63,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/ContextType <p>{{WebExtExamples}}</p> -<div class="note"><strong>Remerciements</strong> +<div class="note"><p><strong>Note :</strong></p> <p>Cette API est basée sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> </div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/create/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/create/index.html index b2c8c6321a..412c463af9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/create/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/create/index.html @@ -23,7 +23,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/create <h2 id="Syntaxe">Syntaxe</h2> -<pre class="syntaxbox brush:js">browser.menus.create( +<pre class="brush: js">browser.menus.create( createProperties, // object function() {...} // optional function ) @@ -33,9 +33,8 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/create <dl> <dt><code>createProperties</code></dt> - <dd><code>object</code>. Propriétés pour le nouvel élément de menu.</dd> - <dd> - <dl class="reference-values"> + <dd><p><code>object</code>. Propriétés pour le nouvel élément de menu.</p> + <dl> <dt><code>checked</code> {{optional_inline}}</dt> <dd><code>boolean</code>. L'état initial d'une case à cocher ou d'un élément radio : <code>true</code> pour selected et <code>false</code> pour non sélectionné. Un seul élément radio peut être sélectionné à la fois dans un groupe donné d'éléments radio.</dd> <dt><code>command</code> {{optional_inline}}</dt> @@ -67,19 +66,19 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/create <dd> <p><code>object</code>. Une ou plusieurs icônes personnalisées à afficher en regard de l'élément. Les icônes personnalisées ne peuvent être définies que pour les éléments apparaissant dans les sous-menus. Cette propriété est un objet avec une propriété pour chaque icône fournie: le nom de la propriété est la taille de l'icône en pixels et sa valeur est un chemin vers l'icône à partir du répertoire racine de l'extension. Le navigateur va essayer de choisir une icône de 16x16 pixels pour un affichage normal ou une icône de 32x32 pixels pour un affichage haute densité. Donc, pour éviter toute mise à l'échelle, vous pouvez spécifier des icônes comme ceci :</p> - <pre class="brush: json no-line-numbers language-json"><code class="language-json"><span class="key token">"icons":</span> <span class="punctuation token">{</span> - <span class="key token">"16":</span> <span class="string token">"path/to/geo-16.png"</span><span class="punctuation token">,</span> - <span class="key token">"32":</span> <span class="string token">"path/to/geo-32.png"</span> - <span class="punctuation token">}</span></code></pre> + <pre class="brush: json">"icons": { + "16": "path/to/geo-16.png", + "32": "path/to/geo-32.png" + }</pre> <p>Vous pouvez également spécifier une seule icône SVG, qui sera mise à l'échelle de manière appropriée :</p> - <pre class="brush: json no-line-numbers language-json"><code class="language-json"><span class="key token">"icons":</span> <span class="punctuation token">{</span> - <span class="key token">"16":</span> <span class="string token">"path/to/geo.svg"</span> - <span class="punctuation token">}</span></code></pre> + <pre class="brush: json">"icons": { + "16": "path/to/geo.svg" + }</pre> - <div class="blockIndicator note"> - <p><strong>Note</strong>: L'élément de menu de niveau supérieur utilise les <a href="/fr/Add-ons/WebExtensions/manifest.json/icons">icônes</a> spécifiées dans le manifest plutôt que ce qui est spécifié avec cette touche.</p> + <div class="note"> + <p><strong>Note :</strong> L'élément de menu de niveau supérieur utilise les <a href="/fr/Add-ons/WebExtensions/manifest.json/icons">icônes</a> spécifiées dans le manifest plutôt que ce qui est spécifié avec cette touche.</p> </div> </dd> <dt><code>id</code> {{optional_inline}}</dt> @@ -185,7 +184,7 @@ browser.menus.onClicked.addListener(function(info, tab) { <p>{{Compat("webextensions.api.menus.create", 10)}}</p> -<div class="note"><strong>Remerciements</strong> +<div class="note"><p><strong>Note :</strong></p> <p>Cette API est basée sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> </div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/createproperties/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/createproperties/index.html index 58db4f6eb7..bae8cfe9ca 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/createproperties/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/createproperties/index.html @@ -7,7 +7,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/createProperties <p>Un <code>object</code> passé au méthodes {{WebExtAPIRef("menus.create()", "menus.create()")}} ou {{WebExtAPIRef("menus.update()", "menus.update()")}} pour décrire les propriétés de l'élément de menu nouveau ou mis à jour.</p> -<dl class="reference-values"> +<dl> <dt><code>checked</code> {{optional_inline}}</dt> <dd><code>boolean</code>. The initial state of a checkbox or radio item: <code>true</code> for selected and <code>false</code> for unselected. Only one radio item can be selected at a time in a given group of radio items.</dd> <dt><code>command</code> {{optional_inline}}</dt> @@ -32,26 +32,26 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/createProperties </ul> </dd> <dt><code>documentUrlPatterns</code> {{optional_inline}}</dt> - <dd><code>array</code> of <code><code>string</code></code>. Lets you restrict the item to apply only to documents whose URL matches one of the given <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">match patterns</a>. This applies to frames as well.</dd> + <dd><code>array</code> of <code><code>string</code></code>. Lets you restrict the item to apply only to documents whose URL matches one of the given <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">match patterns</a>. This applies to frames as well.</dd> <dt><code>enabled</code> {{optional_inline}}</dt> <dd><code>boolean</code>. Whether this menu item is enabled or disabled. Defaults to <code>true</code>.</dd> <dt><code>icons</code> {{optional_inline}}</dt> <dd> <p><code>object</code>. One or more custom icons to display next to the item. Custom icons can only be set for items appearing in submenus. This property is an object with one property for each supplied icon: the property's name should include the icon's size in pixels, and path is relative to the icon from the extension's root directory. The browser tries to choose a 16x16 pixel icon for a normal display or a 32x32 pixel icon for a high-density display. To avoid any scaling, you can specify icons like this:</p> - <pre class="brush: json no-line-numbers language-json"><code class="language-json"><span class="key token">"icons":</span> <span class="punctuation token">{</span> - <span class="key token">"16":</span> <span class="string token">"path/to/geo-16.png"</span><span class="punctuation token">,</span> - <span class="key token">"32":</span> <span class="string token">"path/to/geo-32.png"</span> - <span class="punctuation token">}</span></code></pre> + <pre class="brush: json">"icons": { + "16": "path/to/geo-16.png", + "32": "path/to/geo-32.png" + }</pre> <p>Alternatively, you can specify a single SVG icon, and it will be scaled appropriately:</p> - <pre class="brush: json no-line-numbers language-json"><code class="language-json"><span class="key token">"icons":</span> <span class="punctuation token">{</span> - <span class="key token">"16":</span> <span class="string token">"path/to/geo.svg"</span> - <span class="punctuation token">}</span></code></pre> + <pre class="brush: json">"icons": { + "16": "path/to/geo.svg" + }</pre> - <div class="blockIndicator note"> - <p><strong>Note</strong>: The top-level menu item uses the <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons">icons</a> specified in the manifest rather than what is specified with this key.</p> + <div class="note"> + <p><strong>Note :</strong> The top-level menu item uses the <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons">icons</a> specified in the manifest rather than what is specified with this key.</p> </div> </dd> <dt><code>id</code> {{optional_inline}}</dt> @@ -92,9 +92,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/createProperties <p>{{WebExtExamples}}</p> -<div class="note"><strong>Acknowledgements</strong> +<div class="note"><p><strong>Note :</strong></p> -<p>This API is based on Chromium's <a href="https://developer.chrome.com/extensions/contextMenus#type-OnClickData" style="outline: 1px dotted currentcolor; outline-offset: 0px;"><code>chrome.contextMenus</code></a> API. This documentation is derived from <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> in the Chromium code.</p> +<p>This API is based on Chromium's <a href="https://developer.chrome.com/extensions/contextMenus#type-OnClickData"><code>chrome.contextMenus</code></a> API. This documentation is derived from <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> in the Chromium code.</p> </div> <div class="hidden"> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/gettargetelement/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/gettargetelement/index.html index d45f8004cf..3965d1355d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/gettargetelement/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/gettargetelement/index.html @@ -12,9 +12,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/getTargetElement --- <div>{{AddonSidebar}}</div> -<p class="summary">Renvoie l'élément pour un <code>targetElementId</code> donné</p> +<p>Renvoie l'élément pour un <code>targetElementId</code> donné</p> -<p class="summary">Cette méthode est disponible pour tous les contextes de script d'extension (scripts de contenu, pages de fond et autres pages d'extension) et retourne l'élément pour un <code>info.targetElementId</code> donnée, à condition que l'élément existe toujours dans le document où la méthode est appelée.</p> +<p>Cette méthode est disponible pour tous les contextes de script d'extension (scripts de contenu, pages de fond et autres pages d'extension) et retourne l'élément pour un <code>info.targetElementId</code> donnée, à condition que l'élément existe toujours dans le document où la méthode est appelée.</p> <p>La méthode ne fonctionne que dans le document qui inclut l'élément cliqué avec le bouton droit de la souris et la méthode <code>targetElementId</code> expire lorsque l'utilisateur ouvre un autre menu contextuel.</p> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/index.html index ff1fd72e31..d6bfc9eebc 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/index.html @@ -21,9 +21,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus <p>Avant Firefox 55, cette API s'appelait à l'origine <code>contextMenus</code>, et ce nom a été retenu comme alias. Vous pouvez donc utiliser <code>contextMenus</code> pour écrire du code qui fonctionne dans Firefox et dans d'autres navigateurs.</p> -<p>Pour utiliser cette API, vous devez avoir la <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> des <code>menus.</code> vous pouvez également utiliser l'alias <code>contextMenus</code> à la place des <code>menus</code>, mais si vous le faites, vous devez accéder aux API sous le nom <code>browser.contextMenus</code> à la place.</p> +<p>Pour utiliser cette API, vous devez avoir la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> des <code>menus.</code> vous pouvez également utiliser l'alias <code>contextMenus</code> à la place des <code>menus</code>, mais si vous le faites, vous devez accéder aux API sous le nom <code>browser.contextMenus</code> à la place.</p> -<p>Excepté que <code><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/menus/getTargetElement">menus.getTargetElement()</a></code>, cette API ne peut pas être utilisée à partir de scripts de contenu.</p> +<p>Excepté que <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/menus/getTargetElement">menus.getTargetElement()</a></code>, cette API ne peut pas être utilisée à partir de scripts de contenu.</p> <h2 id="Créer_des_éléments_de_menu">Créer des éléments de menu</h2> @@ -42,23 +42,23 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus <p>Si vous avez créé plus d'un élément de menu contextuel ou plus d'un élément de menu d'outils, les éléments seront placés dans un sous-menu. Le parent du sous-menu sera étiqueté avec le nom de l'extension. Par exemple, voici une extension appelée "Menu démo" qui ajoute deux éléments de menu contextuel:</p> -<p><img alt="" src="https://mdn.mozillademos.org/files/15431/menus-1.png" style="display: block; height: 406px; margin-left: auto; margin-right: auto; width: 500px;"></p> +<p><img alt="" src="menus-1.png"></p> <h2 id="Icônes">Icônes</h2> <p>Si vous avez spécifié des icônes pour votre extension à l'aide de la <a href="/fr/Add-ons/WebExtensions/manifest.json/icons">clé de manifest "icons"</a>, votre élément de menu affichera l'icône spécifiée à côté de son libellé. Le navigateur va essayer de choisir une icône de 16x16 pixels pour un affichage normal ou une icône de 32x32 pixels pour un affichage haute définition :</p> -<p><img alt="" src="https://mdn.mozillademos.org/files/15433/menus-2.png" style="display: block; height: 409px; margin-left: auto; margin-right: auto; width: 500px;"></p> +<p><img alt="" src="menus-2.png"></p> <p>Uniquement pour les éléments d'un sous-menu, vous pouvez spécifier des icônes personnalisées en passant l'option <code>icons</code> à {{WebExtAPIRef("menus.create()")}} :</p> -<p><img alt="" src="https://mdn.mozillademos.org/files/15435/menus-3.png" style="display: block; height: 396px; margin-left: auto; margin-right: auto; width: 500px;"></p> +<p><img alt="" src="menus-3.png"></p> <h2 id="Exemple">Exemple</h2> <p>Voici un menu contextuel contenant 4 éléments: un élément normal, deux éléments radio avec des séparateurs de chaque côté et une case à cocher. Les éléments radio sont dotés d'icônes personnalisées.</p> -<p><img alt="" src="https://mdn.mozillademos.org/files/15437/menus-4.png" style="display: block; height: 790px; margin-left: auto; margin-right: auto; width: 500px;">Vous pouvez créer un sous-menu comme celui-ci en utilisant du code comme :</p> +<p><img alt="" src="menus-4.png">Vous pouvez créer un sous-menu comme celui-ci en utilisant du code comme :</p> <pre class="brush: js">browser.menus.create({ id: "remove-me", @@ -166,7 +166,7 @@ browser.menus.create({ <p>{{WebExtExamples("h2")}}</p> -<div class="note"><strong>Remerciements</strong> +<div class="note"><p><strong>Note :</strong></p> <p>Cette API est basée sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> </div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/itemtype/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/itemtype/index.html index 7ad1905c48..070bc6a36a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/itemtype/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/itemtype/index.html @@ -42,7 +42,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/ItemType <p>{{WebExtExamples}}</p> -<div class="note"><strong>Remerciements</strong> +<div class="note"><p><strong>Note :</strong></p> <p>Cette API est basée sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> </div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/onclickdata/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/onclickdata/index.html index 601167f480..a0385e964c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/onclickdata/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/onclickdata/index.html @@ -21,7 +21,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/OnClickData <p>Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :</p> -<dl class="reference-values"> +<dl> <dt><code>bookmarkId</code> {{optional_inline}}</dt> <dd><code>string</code>. L'ID du signet dans lequel le menu contextuel a été cliqué.***</dd> <dt><code>button</code> {{optional_inline}}</dt> @@ -66,7 +66,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/OnClickData <p>{{WebExtExamples}}</p> -<div class="note"><strong>Remerciements</strong> +<div class="note"><p><strong>Note :</strong></p> <p>Cette API est basée sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> </div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/onclicked/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/onclicked/index.html index ecbb77a4ce..df69d648c9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/onclicked/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/onclicked/index.html @@ -21,7 +21,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/onClicked <h2 id="Syntaxe">Syntaxe</h2> -<pre class="syntaxbox brush:js">browser.menus.onClicked.addListener(listener) +<pre class="brush: js">browser.menus.onClicked.addListener(listener) browser.menus.onClicked.removeListener(listener) browser.menus.onClicked.hasListener(listener) </pre> @@ -46,12 +46,12 @@ browser.menus.onClicked.hasListener(listener) <dd> <p>Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :</p> - <dl class="reference-values"> + <dl> <dt><code>info</code></dt> <dd>{{WebExtAPIRef('menus.OnClickData')}}. Informations sur l'élément cliqué et le contexte dans lequel le clic s'est produit.</dd> </dl> - <dl class="reference-values"> + <dl> <dt><code>tab</code></dt> <dd>{{WebExtAPIRef('tabs.Tab')}}. Les détails de l'onglet où le clic a eu lieu. Si le clic n'a pas eu lieu dans ou sur un onglet, ce paramètre sera manquant.</dd> </dl> @@ -79,7 +79,7 @@ browser.menus.onClicked.addListener((info, tab) => { <p>{{WebExtExamples}}</p> -<div class="note"><strong>Remerciements</strong> +<div class="note"><p><strong>Note :</strong></p> <p>Cette API est basée sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> </div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/onhidden/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/onhidden/index.html index 1ade9c98ad..d2e1c3fd8c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/onhidden/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/onhidden/index.html @@ -24,7 +24,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/onHidden <h2 id="Syntaxe">Syntaxe</h2> -<pre class="syntaxbox brush:js">browser.menus.onHidden.addListener(listener) +<pre class="brush: js">browser.menus.onHidden.addListener(listener) browser.menus.onHidden.removeListener(listener) browser.menus.onHidden.hasListener(listener) </pre> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/onshown/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/onshown/index.html index 400dafd83c..9765d30086 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/onshown/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/onshown/index.html @@ -75,7 +75,7 @@ browser.menus.onHidden.addListener(function() { <h2 id="Syntaxe">Syntaxe</h2> -<pre class="syntaxbox brush:js">browser.menus.onShown.addListener(listener) +<pre class="brush: js">browser.menus.onShown.addListener(listener) browser.menus.onShown.removeListener(listener) browser.menus.onShown.hasListener(listener) </pre> @@ -100,7 +100,7 @@ browser.menus.onShown.hasListener(listener) <dd> <p>Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :</p> - <dl class="reference-values"> + <dl> <dt><code>info</code></dt> <dd> <p><code>Object</code>. Ceci est juste comme l'objet {{WebExtAPIRef('menus.OnClickData')}}, sauf qu'il contient deux propriétés supplémentaires:</p> @@ -116,7 +116,7 @@ browser.menus.onShown.hasListener(listener) </dd> </dl> - <dl class="reference-values"> + <dl> <dt><code>tab</code></dt> <dd>{{WebExtAPIRef('tabs.Tab')}}. Les détails de l'onglet où le clic a eu lieu. Si le clic n'a pas eu lieu dans ou sur un onglet, ce paramètre sera manquant.</dd> </dl> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/overridecontext/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/overridecontext/index.html index 6869036f24..739b9acbd5 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/overridecontext/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/overridecontext/index.html @@ -21,7 +21,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/overrideContext <h2 id="Syntaxe">Syntaxe</h2> -<pre class="syntaxbox brush:js">browser.menus.overrideContext( +<pre class="brush: js">browser.menus.overrideContext( contextOptions // object )</pre> @@ -29,8 +29,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/overrideContext <dl> <dt><code>contextOptions</code></dt> - <dd><code>object</code>. Options sur la façon dont les menus contextuels seront remplacés.</dd> - <dd> + <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> @@ -40,7 +39,6 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/overrideContext <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> - <dt></dt> </dl> </dd> </dl> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/refresh/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/refresh/index.html index b0b332523c..925305277d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/refresh/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/refresh/index.html @@ -26,7 +26,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/refresh <h2 id="Syntaxe">Syntaxe</h2> -<pre class="syntaxbox brush:js">browser.menus.refresh() +<pre class="brush: js">browser.menus.refresh() </pre> <h3 id="Paramètres">Paramètres</h3> @@ -45,20 +45,20 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/refresh <p>Cet exemple permet d'afficher le menu contextuel sur un lien, puis met à jour l'élément de menu <code>openLabelledId</code> menu item avec le nom d'hôte du lien :</p> -<pre class="brush: js line-numbers language-js"><code class="language-js"><span class="keyword token">function</span> <span class="function token">updateMenuItem</span><span class="punctuation token">(</span>linkHostname<span class="punctuation token">)</span> <span class="punctuation token">{</span> - browser<span class="punctuation token">.</span>menus<span class="punctuation token">.</span><span class="function token">update</span><span class="punctuation token">(</span>openLabelledId<span class="punctuation token">,</span> <span class="punctuation token">{</span> - title<span class="punctuation token">:</span> <span class="template-string token"><span class="string token">`Open (</span><span class="interpolation token"><span class="interpolation-punctuation punctuation token">${</span>linkHostname<span class="interpolation-punctuation punctuation token">}</span></span><span class="string token">)`</span></span> - <span class="punctuation token">}</span><span class="punctuation token">)</span><span class="punctuation token">;</span> - browser<span class="punctuation token">.</span>menus<span class="punctuation token">.</span><span class="function token">refresh</span><span class="punctuation token">(</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="punctuation token">}</span> - -browser<span class="punctuation token">.</span>menus<span class="punctuation token">.</span>onShown<span class="punctuation token">.</span><span class="function token">addListener</span><span class="punctuation token">(</span>info <span class="operator token">=</span><span class="operator token">></span> <span class="punctuation token">{</span> - <span class="keyword token">if</span> <span class="punctuation token">(</span><span class="operator token">!</span>info<span class="punctuation token">.</span>linkUrl<span class="punctuation token">)</span> <span class="punctuation token">{</span> - <span class="keyword token">return</span><span class="punctuation token">;</span> - <span class="punctuation token">}</span> - <span class="keyword token">let</span> linkElement <span class="operator token">=</span> document<span class="punctuation token">.</span><span class="function token">createElement</span><span class="punctuation token">(</span><span class="string token">"a"</span><span class="punctuation token">)</span><span class="punctuation token">;</span> - linkElement<span class="punctuation token">.</span>href <span class="operator token">=</span> info<span class="punctuation token">.</span>linkUrl<span class="punctuation token">;</span> - <span class="function token">updateMenuItem</span><span class="punctuation token">(</span>linkElement<span class="punctuation token">.</span>hostname<span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="punctuation token">}</span><span class="punctuation token">)</span><span class="punctuation token">;</span></code></pre> +<pre class="brush: js">function updateMenuItem(linkHostname) { + browser.menus.update(openLabelledId, { + title: `Open (${linkHostname})` + }); + browser.menus.refresh(); +} + +browser.menus.onShown.addListener(info => { + if (!info.linkUrl) { + return; + } + let linkElement = document.createElement("a"); + linkElement.href = info.linkUrl; + updateMenuItem(linkElement.hostname); +});</pre> <p>{{WebExtExamples}}</p> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/remove/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/remove/index.html index a6e1615400..e3084010cf 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/remove/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/remove/index.html @@ -23,7 +23,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/remove <h2 id="Syntaxe">Syntaxe</h2> -<pre class="syntaxbox brush:js">var removing = browser.menus.remove( +<pre class="brush: js">var removing = browser.menus.remove( menuItemId // integer or string ) </pre> @@ -70,7 +70,7 @@ browser.menus.onClicked.addListener(function(info, tab) { <p>{{Compat("webextensions.api.menus.remove", 10)}}</p> -<div class="note"><strong>Remerciements</strong> +<div class="note"><p><strong>Note :</strong></p> <p>Cette API est basée sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> </div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/removeall/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/removeall/index.html index 6ea092abf2..5654a5e15c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/removeall/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/removeall/index.html @@ -24,7 +24,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/removeAll <h2 id="Syntaxe">Syntaxe</h2> -<pre class="syntaxbox brush:js">var removing = browser.menus.removeAll() +<pre class="brush: js">var removing = browser.menus.removeAll() </pre> <h3 id="Paramètres">Paramètres</h3> @@ -68,7 +68,7 @@ browser.menus.onClicked.addListener(function(info, tab) { <p>{{WebExtExamples}}</p> -<div class="note"><strong>Remerciements</strong> +<div class="note"><p><strong>Note :</strong></p> <p>Cette API est basée sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> </div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/update/index.html b/files/fr/mozilla/add-ons/webextensions/api/menus/update/index.html index 7be73f170d..762d21d228 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/update/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/update/index.html @@ -23,7 +23,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/update <h2 id="Syntaxe">Syntaxe</h2> -<pre class="syntaxbox brush:js">var updating = browser.menus.update( +<pre class="brush: js">var updating = browser.menus.update( id, // integer or string updateProperties // object ) @@ -35,8 +35,8 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/update <dt><code>id</code></dt> <dd><code><code>integer</code></code> ou <code><code>string</code></code>. L'ID de l'article à mettre à jour.</dd> <dt><code>updateProperties</code></dt> - <dd><code>object</code>. Les propriétés à mettre à jour. Identique à l'objet <code>createProperties</code> passé à {{WebExtAPIRef("menus.create()", "menus.create()")}}, sauf que l'<code>id</code> ne peut être défini. En outre, les <code>icônes</code> ne peuvent être modifiées que dans les commandes de menu, et non dans le menu contextuel de niveau supérieur. L'icône de niveau supérieur correspond à l'icône principale de l'extension telle que déclarée dans le fichier manifeste de l'extension. - <dl class="reference-values"> + <dd><p><code>object</code>. Les propriétés à mettre à jour. Identique à l'objet <code>createProperties</code> passé à {{WebExtAPIRef("menus.create()", "menus.create()")}}, sauf que l'<code>id</code> ne peut être défini. En outre, les <code>icônes</code> ne peuvent être modifiées que dans les commandes de menu, et non dans le menu contextuel de niveau supérieur. L'icône de niveau supérieur correspond à l'icône principale de l'extension telle que déclarée dans le fichier manifeste de l'extension.</p> + <dl> <dt><code>checked</code> {{optional_inline}}</dt> <dd><code>boolean</code>. L'état initial d'une case à cocher ou d'un élément radio : <code>true</code> fpour sélectionné et <code>false</code> pour non sélectionné. Un seul élément radio peut être sélectionné à la fois dans un groupe donné d'éléments radio.</dd> <dt><code>command</code> {{optional_inline}}</dt> @@ -61,26 +61,26 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/update </ul> </dd> <dt><code>documentUrlPatterns</code> {{optional_inline}}</dt> - <dd><code>array</code> de <code><code>string</code></code>. Vous permet de limiter l'élément à s'appliquer uniquement aux documents dont l'URL correspond à l'un des éléments <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">motifs</a> de données. Ceci s'applique également aux cadres.</dd> + <dd><code>array</code> de <code><code>string</code></code>. Vous permet de limiter l'élément à s'appliquer uniquement aux documents dont l'URL correspond à l'un des éléments <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">motifs</a> de données. Ceci s'applique également aux cadres.</dd> <dt><code>enabled</code> {{optional_inline}}</dt> <dd><code>boolean</code>. Si cet élément de menu est activé ou désactivé. La valeur par défaut est <code>true</code>.</dd> <dt><code>icons</code> {{optional_inline}}</dt> <dd> <p><code>object</code>. Une ou plusieurs icônes personnalisées à afficher à côté de l'élément. Les icônes personnalisées ne peuvent être définies que pour les éléments apparaissant dans les sous-menus. Cette propriété est un objet avec une propriété pour chaque icône fournie : le nom de la propriété doit inclure la taille de l'icône en pixels, et le chemin est relatif à l'icône du répertoire racine de l'extension. Le navigateur essaie de choisir une icône 16x16 pixels pour un affichage normal ou une icône 32x32 pixels pour un affichage haute densité. Pour éviter toute mise à l'échelle, vous pouvez spécifier des icônes comme celle-ci :</p> - <pre class="brush: json no-line-numbers language-json"><code class="language-json"><span class="key token">"icons":</span> <span class="punctuation token">{</span> - <span class="key token">"16":</span> <span class="string token">"path/to/geo-16.png"</span><span class="punctuation token">,</span> - <span class="key token">"32":</span> <span class="string token">"path/to/geo-32.png"</span> - <span class="punctuation token">}</span></code></pre> + <pre class="brush: json">"icons": { + "16": "path/to/geo-16.png", + "32": "path/to/geo-32.png" + }</pre> <p>Alternativement, vous pouvez spécifier une seule icône SVG, et elle sera mise à l'échelle de manière appropriée :</p> - <pre class="brush: json no-line-numbers language-json"><code class="language-json"><span class="key token">"icons":</span> <span class="punctuation token">{</span> - <span class="key token">"16":</span> <span class="string token">"path/to/geo.svg"</span> - <span class="punctuation token">}</span></code></pre> + <pre class="brush: json">"icons": { + "16": "path/to/geo.svg" + }</pre> - <div class="blockIndicator note"> - <p><strong>Note</strong>: The top-level menu item uses the <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons">icons</a> specified in the manifest rather than what is specified with this key.</p> + <div class="note"> + <p><strong>Note :</strong> The top-level menu item uses the <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons">icons</a> specified in the manifest rather than what is specified with this key.</p> </div> </dd> <dt><code>id</code> {{optional_inline}}</dt> @@ -154,7 +154,7 @@ browser.menus.onClicked.addListener(function(info, tab) { <p>{{Compat("webextensions.api.menus.update", 10)}}</p> -<div class="note"><strong>Remerciements</strong> +<div class="note"><p><strong>Note :</strong></p> <p>Cette API est basée sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> </div> |