Esta tradução está incompleta. Por favor, ajude a traduzir este artigo do Inglês.

Normalmente referido como uma ação do navegador, esta opção da interface do utilizador é um botão adicionado à barra de ferramentas do navegador. Os utilizadores clicam no botão para interagir com a sua extensão.

Utilize este botão quando as funcionalidades da sua extensão forem aplicáveis ​​a quase todas as páginas da Web. O botão da barra de ferramentas está visível em todas os separadores do navegador.

Compare com o botão da barra de endereço, que oferece um comportamento similar mas que é utilizado em situações onde a extensão precisa de ser acedida apenas nas páginas específicas.

Especificar a ação do navegador

Define as propriedades da ação do navegador utilizando a chave browser_action em manifest.json:

"browser_action": {
  "default_icon": {
    "19": "button/geo-19.png",
    "38": "button/geo-38.png"
  },
  "default_title": "Whereami?"
}

The only mandatory key is default_icon.

There are two ways to specify a browser action: with or without a popup. If you don't specify a popup, when the user clicks the button an event is dispatched to the extension, which the extension listens for using browserAction.onClicked:

browser.browserAction.onClicked.addListener(handleClick);

If you specify a popup, the click event is not dispatched: instead, the popup is shown when the user clicks the button. The user is able to interact with the popup and it closes automatically when the user clicks outside it. See the Popup article for more details on creating and managing popups.

Note that your extension can have only one browser action.

You can change any of the browser action properties programmatically using the browserAction API.

Exemplos

The webextensions-examples repo on GitHub contains several examples of extensions that uses browser actions:

  • bookmark-it uses a browser action without a popup.
  • beastify uses a browser action with a popup.

Etiquetas do documento e contribuidores

Etiquetas: 
 Contribuidores para esta página: mansil
 Última atualização por: mansil,