Voer een actie uit

Een actie is wat er gebeurt wanneer een gebruiker op het pictogram in de werkbalk klikt, meestal het actiepictogram van uw extensie genoemd. Een actie roept een extensiefunctie aan met behulp van de Action API of opent een pop-upvenster . Op deze pagina wordt uitgelegd hoe u een extensiefunctie aanroept. Zie ' Een pop-upvenster toevoegen' voor meer informatie over het gebruik van een pop-upvenster .

Registreer de actie

Om de chrome.action API te gebruiken, voegt u de sleutel "action" toe aan het manifestbestand van de extensie. Zie het manifestgedeelte van de chrome.action API-referentie voor een volledige beschrijving van de optionele eigenschappen van dit veld.

manifest.json:

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

Reageer op de actie

Registreer een onClicked handler voor het moment dat de gebruiker op het actie-icoon klikt. Deze gebeurtenis wordt niet geactiveerd als er een pop-up is geregistreerd in het manifest.json-bestand.

service-worker.js:

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

Activeer de actie voorwaardelijk

Met de chrome.declarativeContent API kun je het actie-icoon van een extensie inschakelen op basis van de URL van de pagina of wanneer CSS-selectors overeenkomen met elementen op de pagina. Wanneer het actie-icoon van een extensie is uitgeschakeld, is het grijs weergegeven. Als de gebruiker op het uitgeschakelde icoon klikt, verschijnt het contextmenu van de extensie.

Een uitgeschakeld actie-icoon
Een uitgeschakeld actie-icoon.

Actiebadge

Badges zijn stukjes opgemaakte tekst die boven het actie-icoon worden geplaatst om bijvoorbeeld de status van een extensie aan te geven of dat er acties van de gebruiker worden vereist. Om dit te illustreren, toont het voorbeeld 'Water drinken ' een badge met 'AAN' om de gebruiker te laten weten dat er succesvol een alarm is ingesteld, en wordt er niets weergegeven wanneer de extensie inactief is. Badges kunnen maximaal vier tekens bevatten.

Een extensie-icoon zonder badge en met een badge.
Een extensie-icoon met een badge (links) en zonder badge (rechts).

Stel de tekst van de badge in door chrome.action.setBadgeText() aan te roepen en de achtergrondkleur door chrome.action.setBadgeBackgroundColor() aan te roepen.

service-worker.js:

chrome.action.setBadgeText({text: 'ON'});
chrome.action.setBadgeBackgroundColor({color: '#4688F1'});

Tooltip

Registreer tooltips in het veld "default_title" onder de sleutel "action" in het manifest.json-bestand.

manifest.json:

{
  "name": "Tab Flipper",
 ...
  "action": {
    "default_title": "Press Ctrl(Win)/Command(Mac)+Shift+Right/Left to flip tabs"
  }
...
}

Je kunt tooltips ook instellen of bijwerken door action.setTitle() aan te roepen. Als er geen tooltip is ingesteld, wordt de naam van de extensie weergegeven.