Implementare un'azione

Un'azione è ciò che accade quando un utente fa clic sull'icona della barra degli strumenti, solitamente chiamata icona di azione per la tua estensione. Un'azione richiama una funzionalità di estensione utilizzando l'API Action o apre un popup. Questa pagina mostra come richiamare una funzionalità di estensione. Per utilizzare un popup, vedi Aggiungere un popup.

Registra l'azione

Per utilizzare l'API chrome.action, aggiungi la chiave "action" al file manifest dell'estensione. Per una descrizione completa delle proprietà facoltative di questo campo, consulta la sezione del manifest del riferimento API chrome.action.

manifest.json:

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

Rispondere all'azione

Registra un gestore onClicked per quando l'utente fa clic sull'icona dell'azione. Questo evento non viene attivato se un popup è registrato nel file manifest.json.

service-worker.js:

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

Attivare l'azione in modo condizionale

L'API chrome.declarativeContent consente di attivare l'icona di azione dell'estensione in base all'URL della pagina o quando i selettori CSS corrispondono agli elementi della pagina. Quando l'icona di azione di un'estensione è disattivata, l'icona è visualizzata in grigio. Se l'utente fa clic sull'icona disattivata, viene visualizzato il menu contestuale dell'estensione.

Badge Azione

I badge sono frammenti di testo formattato posizionati sopra l'icona dell'azione per indicare, ad esempio, lo stato dell'estensione o che sono richieste azioni da parte dell'utente. Per dimostrarlo, l'esempio Bevi acqua mostra un badge con "ON" per indicare all'utente che ha impostato correttamente una sveglia e non mostra nulla quando l'estensione è inattiva. I badge possono contenere fino a quattro caratteri.

Imposta il testo del badge chiamando chrome.action.setBadgeText() e il colore di sfondo chiamando chrome.action.setBadgeBackgroundColor().

service-worker.js:

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

Descrizione comando

Registra le descrizioni comando nel campo "default_title" sotto la chiave "action" nel file manifest.json.

manifest.json:

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

Puoi anche impostare o aggiornare i suggerimenti chiamando il numero action.setTitle(). Se non è impostata alcuna descrizione comando, viene visualizzato il nome dell'estensione.