Voer een actie uit

Een actie is wat er gebeurt wanneer een gebruiker op het werkbalkpictogram klikt, meestal het actiepictogram voor uw extensie genoemd. Een actie roept een extensiefunctie aan met behulp van de Action API of opent een pop-up . Deze pagina laat zien hoe u een extensiefunctie kunt aanroepen. Zie Een pop-up toevoegen om een ​​pop-up te gebruiken.

Registreer de actie

Als u de chrome.action API wilt gebruiken, voegt u de "action" -sleutel 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 wanneer de gebruiker op het actiepictogram klikt. Deze gebeurtenis wordt niet geactiveerd als er een pop-up is geregistreerd in het bestand manifest.json.

service-werker.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 kunt u het actiepictogram van de extensie inschakelen op basis van de pagina-URL of wanneer CSS-kiezers overeenkomen met de elementen op de pagina. Wanneer het actiepictogram van een extensie is uitgeschakeld, wordt het pictogram grijs weergegeven. Als de gebruiker op het uitgeschakelde pictogram klikt, verschijnt het contextmenu van de extensie.

Een uitgeschakeld actiepictogram.

Actie-badge

Badges zijn stukjes opgemaakte tekst die bovenop het actiepictogram worden geplaatst om bijvoorbeeld de status van de extensie aan te geven of dat er acties vereist zijn door de gebruiker. Om dit aan te tonen wordt in het Drinkwater- voorbeeld een badge met "AAN" weergegeven om de gebruiker te laten zien dat hij/zij met succes een alarm heeft ingesteld. Er wordt niets weergegeven wanneer het toestel inactief is. Badges kunnen maximaal vier tekens bevatten.

Een extensiepictogram zonder badge (links) en met 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-werker.js:

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

Tooltip

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

manifest.json:

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

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