Cette page a été traduite par l'API Cloud Translation.

Implémenter une action

Une action se produit lorsqu'un utilisateur clique sur l'icône de la barre d'outils, généralement appelée icône d'action pour votre extension. Une action appelle une fonctionnalité d'extension à l'aide de l'API Action ou ouvre un pop-up. Cette page explique comment appeler une fonctionnalité d'extension. Pour utiliser un pop-up, consultez Ajouter un pop-up.

Enregistrer l'action

Pour utiliser l'API chrome.action, ajoutez la clé "action" au fichier manifeste de l'extension. Consultez la section du fichier manifeste dans la documentation de référence de l'API chrome.action pour obtenir une description complète des propriétés facultatives de ce champ.

manifest.json:

{
  "name": "My Awesome action Extension",
 ...
  "action": {
   ...
  }
 ...
}

Répondre à l'action

Enregistrez un gestionnaire onClicked lorsque l'utilisateur clique sur l'icône d'action. Cet événement ne se déclenche pas si un pop-up est enregistré dans le fichier manifest.json.

service-worker.js:

chrome.action.onClicked.addListener((tab) => {
  chrome.action.setTitle({
    tabId: tab.id,
    title: `You are on tab: ${tab.id}`});
});

Activer l'action de manière conditionnelle

L'API chrome.declarativeContent vous permet d'activer l'icône d'action de l'extension en fonction de l'URL de la page ou lorsque les sélecteurs CSS correspondent aux éléments de la page. Lorsque l'icône d'action d'une extension est désactivée, elle est grisée. Si l'utilisateur clique sur l'icône de désactivation, le menu contextuel de l'extension s'affiche.

Badge d'action

Les badges sont des extraits de texte mis en forme placés au-dessus de l'icône d'action pour indiquer des éléments tels que l'état de l'extension ou que des actions sont requises par l'utilisateur. L'exemple Boire de l'eau affiche un badge "ACTIVÉ" pour indiquer à l'utilisateur qu'il a correctement défini une alarme et n'affiche rien lorsque l'extension est inactive. Les badges peuvent contenir jusqu'à quatre caractères.

Une icône d'extension sans badge et avec un badge. — Une icône d'extension sans badge (à gauche) et avec badge (à droite).

Définissez le texte du badge en appelant chrome.action.setBadgeText() et la couleur d'arrière-plan en appelant chrome.action.setBadgeBackgroundColor()`.