1 files changed, 109 insertions, 0 deletions
diff --git a/files/fr/mozilla/add-ons/webextensions/user_interface/page_actions/index.md b/files/fr/mozilla/add-ons/webextensions/user_interface/page_actions/index.md
new file mode 100644
index 0000000000..843266e618
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/user_interface/page_actions/index.md
@@ -0,0 +1,109 @@
+---
+title: Bouton de la barre d'adresse
+slug: Mozilla/Add-ons/WebExtensions/user_interface/Page_actions
+tags:
+  - AddresseBarButton
+  - Page Action
+  - User Interface
+  - WebExtensions
+translation_of: Mozilla/Add-ons/WebExtensions/user_interface/Page_actions
+---
+<div>{{AddonSidebar}}</div>
+
+<p>Généralement appelée <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/pageAction">action de page</a>, cette option d'interface utilisateur est un bouton ajouté à la barre d'adresse du navigateur. Les utilisateurs cliquent sur le bouton pour interagir avec votre extension.</p>
+
+<p><img alt="" src="address_bar_button.png"></p>
+
+<h2 id="Actions_de_pages_et_actions_du_navigateur">Actions de pages et actions du navigateur</h2>
+
+<p>Le bouton de la barre d'adresse (ou action de la page) est très semblable au bouton de la barre d'outils (ou action du navigateur).</p>
+
+<p>Les différences sont :</p>
+
+<ul>
+ <li><strong>L'emplacement du bouton :</strong>
+
+  <ul>
+   <li>L'action de la page s'affiche dans la barre d'adresse du navigateur.</li>
+   <li>L'action du navigateur s'affiche en dehors de la barre d'adresse, dans la barre d'outils du navigateur.</li>
+  </ul>
+ </li>
+ <li>La visibilité du bouton <strong>:</strong>
+  <ul>
+   <li>L'action page est masquée par défaut (bien que cette valeur par défaut puisse être modifiée via les propriétés <a href="/fr/Add-ons/WebExtensions/manifest.json/page_action">manifest </a>des clés <code>show_matches</code> et <code>hide_matches</code>), et vous appelez <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/PageAction/show"><code>pageAction.show()</code></a> et <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/PageAction/hide"><code>pageAction.hide()</code></a> pour l'afficher ou la masquer dans des onglets spécifiques.</li>
+   <li>L'action du navigateur est toujours affichée.</li>
+  </ul>
+ </li>
+</ul>
+
+<p>Utilisez une action de page lorsque l'action est liée à la page en cours, et une action navigateur lorsque l'action est liée au navigateur dans son ensemble ou à trop de pages. Par exemple :</p>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="row">Type</th>
+   <th scope="col">Bookmarks action</th>
+   <th scope="col">Content action</th>
+   <th scope="col">Tabs operation</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <th scope="row">page action</th>
+   <td>Bookmark this page</td>
+   <td>Reddit enhancement</td>
+   <td>Send tab</td>
+  </tr>
+  <tr>
+   <th scope="row">browser action</th>
+   <td>Show all bookmarks</td>
+   <td>Enable ad-blocking</td>
+   <td>Sync all open tabs</td>
+  </tr>
+ </tbody>
+</table>
+
+
+
+<h2 id="Spécification_de_l'action_de_la_page">Spécification de l'action de la page</h2>
+
+<p>Vous définissez les propriétés de la clé de l'<code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/page_action">action de page</a></code> dans le manifest.json:</p>
+
+<pre class="brush: json">"page_action": {
+  "browser_style": true,
+  "default_icon": {
+    "19": "button/geo-19.png",
+    "38": "button/geo-38.png"
+  },
+  "default_title": "Whereami?",
+}</pre>
+
+<p>La seule clé obligatoire est <code>default_icon</code>.</p>
+
+<p>Il y a deux façons de spécifier une action de page : avec ou sans <a href="/fr/Add-ons/WebExtensions/Popups">popup</a>.</p>
+
+<ul>
+ <li><strong>Sans popup:</strong> Lorsque l'utilisateur clique sur le bouton, un événement est envoyé à l'extension, que l'extension écoute pour utiliser <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/pageAction/onClicked"><code>pageAction.onClicked</code></a>:</li>
+ <li>
+  <pre class="brush: js">browser.pageAction.onClicked.addListener(handleClick);</pre>
+ </li>
+ <li><strong>Avec un popup:</strong> L'événement <code>click</code> n'est pas envoyé. Au lieu de cela, le popup apparaît lorsque l'utilisateur clique sur le bouton. L'utilisateur interagit alors avec le popup. Lorsque l'utilisateur clique à l'extérieur de la fenêtre contextuelle, celle-ci se ferme automatiquement. Voir l'article <a href="/fr/Add-ons/WebExtensions/Popups">Popup </a>pour plus de détails sur la création et la gestion des popups.</li>
+</ul>
+
+<p>Notez que votre extension ne peut avoir qu'une seule page action.</p>
+
+<p>Vous pouvez modifier l'une des propriétés d'action de la page de manière programmée en utilisant l'API de la <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/pageAction">pageAction</a></code>.</p>
+
+<h2 id="Icônes">Icônes</h2>
+
+<p>Pour plus de détails sur la création d'icônes à utiliser avec l'action de votre page, voir   <a href="https://design.firefox.com/photon/visuals/iconography.html">Iconography</a> dans la documentation du <a href="https://design.firefox.com/photon/index.html">Photon Design System</a>.</p>
+
+
+
+<h2 id="Exemples">Exemples</h2>
+
+<p>Le dépôt <a href="https://github.com/mdn/webextensions-examples">webextensions-examples</a> sur GitHub contient plusieurs exemples de WebExtensions qui utilisent la page action :</p>
+
+<ul>
+ <li><a href="https://github.com/mdn/webextensions-examples/tree/master/chill-out">chill-out</a> utilise une action de navigateur sans popup</li>
+</ul>