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
)

BCD tables only load in the browser

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.

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

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"
  });
});

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.