Modules

Bouton de la barre d'adresse

Généralement appelée action de page, 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.

Utilisez ce bouton lorsqu'une fonctionnalité n'est pertinente que pour certaines pages Web. Par défaut, le bouton de la barre d'adresse est masqué dans tous les onglets du navigateur et vous appelez pageAction.show() et pageAction.hide() pour afficher ou le cacher dans des onglets spécifiques.

Comparez avec le bouton de la barre d'outils, qui offre un comportement similaire mais est utilisé dans les situations où les fonctionnalités de l'extensions s'appliquent à presque toutes les pages webs.

Spécification de l'action de la page

Vous définissez les propriétés de la clé de l'action de page dans le manifest.json:

"page_action": {
  "browser_style": true,
  "default_icon": {
    "19": "button/geo-19.png",
    "38": "button/geo-38.png"
  },
  "default_title": "Whereami?",
}

La seule clé obligatoire est default_icon.

Il existe deux façons de spécifier une action de page: avec ou sans popup. Si vous ne spécifiez pas de popup, lorsque l'utilisateur clique sur le bouton un événement es déclanché à l'extension, qu'il utilise à partir de pageAction.onClicked:

browser.pageAction.onClicked.addListener(handleClick);

Si vous spécifiez une fenêtre contextuelle, l'événement de clic n'est pas envoyé: à la place, le popup s'affiche lorsque l'utilisateur clique sur le bouton. L'utilisateur peut interagir avec le popup et il se ferme automatiquement lorsque l'utilisateur clique à l'extérieur. Consultez l'article Popup pour plus de détails sur la création et la gestion des fenêtres pop-up.

Notez que votre extension ne peut avoir qu'une seule page action.

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 pageAction.

Exemples

Le depot webextensions-examples sur GitHub contient plusieurs exemples de WebExtensions qui utilisent la page action:

  • chill-out utilise une action de navigateur sans popup

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : hellosct1
 Dernière mise à jour par : hellosct1,