Modules

pageAction.setIcon()

Définit l'icône de l'action de la page

Vous pouvez spécifié un seule icône comme chemin d'accès à un fichier image ou un objet pageAction.ImageDataType.

Vous pouvez spécifier plusieurs icônes de différentes tailles en fournissant un dictionnaire contenant plusieurs chemins ou objets ImageData. Cela signifie que l'icône ne doit pas être mise à l'échelle pour un périphérique avec une densité de pixels différente.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var settingIcon = browser.pageAction.setIcon(
  details         // object
)

Paramètres

details
object. Un objet contenant les propriétés imageData ou path , et éventuellement une propriété tabId.
imageDataFacultatif

pageAction.ImageDataType ou object. C'est un objet ImageData unique ou un dictionnaire d'objets.

Utilisation un dictionnaire d'objets pour spécifier de multiple objets ImageData dans différentes tailles, de sorte que l'icône ne doit pas être mise à l'échelle pour un périphérique avec une densité de pixel différente. Si imageData est un dictionnaire, la valeur  de chaque propriété est un objet ImageData , et le nom est sa taille, comme ceci :

{
  16: image16,
  32: image32
}

Le navigateur choisira l'image à utiliser en fonction de la densité de pixels de l'écran. Voir Choisir les tailles d'icônes pour plus d'informations à ce sujet.

pathFacultatif

string ou object. C'est soit un chemin relatif vers un fichier icône  ou objet dictionnaire. 

Utilisez un dictionnaire d'objets pour spécifier plusieurs fichiers d'icônes de différentes tailles, de sorte que l'icône ne doit pas être mise à l'échelle pour un périphérique avec une densité de pixels différente. Si path est un dictionnaire, la valeur de chaque propriété est un chemin relatif, et son nom est sa taille, comme ceci :

{
  16: "path/to/image16.jpg",
  32: "path/to/image32.jpg"
}

Le navigateur choisira l'image à utiliser en fonction de la densité de pixels de l'écran. Voir Choisir les tailles d'icônes pour plus d'informations à ce sujet.

tabId
integer. L'ID de l'onglet dont vous voulez définir l'icône.

Valeur retournée

Une Promise qui sera accompli sans arguments une fois l'icône définie.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui1 Oui45 Non15
imageData23 Non45 Non15

1. Before Chrome 23, `path` couldn't specify multiple icon files, but had to be a string specifying a single icon path.

Exemples

Définissez l'icône de l'action de la page lorsque l'utilisateur clique dessus :

browser.pageAction.onClicked.addListener((tab) => {
  browser.pageAction.setIcon({
    tabId: tab.id, path: "icons/icon-48.png"
  });
});

Example extensions

Remerciements :

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

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

Étiquettes et contributeurs liés au document

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