É um catálogo de elementos da interface do usuário disponíveis em extensões. Cada entrada contém:
- Uma imagem do elemento (se aplicável).
- Uma descrição da finalidade.
- Elementos da interface relacionados (se aplicável).
- Links para instruções de implementação e exemplos de código.
Esses elementos são diferentes maneiras de invocar recursos de extensão. Não é necessário implementar todos eles. Na verdade, alguns casos de uso podem não usar nenhum deles. Por exemplo, um encurtador de links pode agir no URL exibido usando um atalho de teclado e colocar o link encurtado na área de transferência de forma programática.
Ações
Uma ação é o que acontece quando um usuário clica no ícone de ação da sua extensão. Uma ação pode invocar um recurso de extensão usando a API Action ou abrir um pop-up que permite aos usuários invocar vários recursos de extensão. Use uma dica para explicar aos usuários o que a ação faz.
Para aprender a criar uma ação, consulte Implementar uma ação ou examine os exemplos de ações.
Ícones de ação
Uma extensão precisa de pelo menos um ícone para representá-la. Os usuários clicam no ícone para invocar uma ação, seja ela invocando um recurso de extensão usando a API Action ou abrindo um pop-up.
Você também pode adicionar um rótulo, chamado de "selo", ao ícone para comunicar coisas como o estado da extensão ou que ações são necessárias pelo usuário.
Para aprender a criar uma ação, consulte Implementar uma ação ou examine os exemplos de ações.
Selos
Os selos são partes de texto formatado colocadas em cima do ícone de ação para indicar coisas como o estado da extensão ou que ações são necessárias pelo usuário. Para definir o texto do selo, chame browser.action.setBadgeText(). Para definir a cor do banner, chame browser.action.setBadgeBackgroundColor().
Para aprender a criar uma ação, consulte Implementar uma ação ou o exemplo Beber água.
Comandos
Os comandos são combinações de teclas que invocam um recurso de extensão. Defina combinações de teclas no arquivo manifest.json e responda a elas usando a API Commands.
Para aprender a implementar um comando, consulte a referência da API ou o exemplo browser.commands.
Menu de contexto
Um menu de contexto aparece para o clique alternativo (geralmente chamado de clique com o botão direito do mouse). Defina menus de contexto usando a API Context Menus.
Para aprender a implementar um menu de contexto, consulte os exemplos de menu de contexto.
Omnibox
Você pode interagir com os usuários usando a omnibox do Chrome. Quando um usuário insere palavras-chave definidas pela extensão na omnibox, sua extensão controla o que ele vê. Defina palavras-chave no manifest.json e responda a elas usando a API Omnibox.
Para aprender a substituir a omnibox, consulte "Acionar ações na omnibox" ou o exemplo de referência rápida da API.
Substituir páginas
Uma extensão pode substituir uma destas páginas integradas do Chrome:
- Histórico
- Nova guia
- Favoritos
Para aprender a substituir páginas do Chrome, consulte Substituir páginas do Chrome ou o exemplo de substituição.
Pop-ups
Um pop-up é uma ação que mostra uma janela para os usuários invocarem vários recursos da extensão. Os pop-ups podem ser abertos se o usuário clicar no ícone de ação, usando um atalho de teclado ou chamando browser.action.openPopup().
Para aprender a criar um pop-up, consulte Adicionar um pop-up. Você também pode baixar uma etapa usando um dos exemplos de ação.
Painéis laterais
Um painel lateral permite que os usuários invoquem recursos de extensão ao lado de páginas da Web (consulte a imagem). Um painel lateral pode ser anexado a uma única guia ou a uma janela inteira. Um painel lateral é controlado usando a API Side Panel.
Para aprender a criar um painel lateral, consulte os casos de uso do painel lateral ou examine os exemplos.
Dicas
Uma dica é uma maneira de mostrar, quando um usuário passa o mouse sobre o ícone de ação, o que a ação da sua extensão faz. Por padrão, a dica mostra o nome da extensão.
Para aprender a adicionar uma dica, use o membro "default_title" da chave "action" dos arquivos de manifesto.
DevTools
É possível adicionar painéis personalizados (o que as guias são chamadas no DevTools) usando a API DevTools Panels. Outras APIs do DevTools permitem monitorar janelas e tráfego de rede. Também é possível personalizar o painel de gravador das DevTools. O painel do Lighthouse no Chrome DevTools começou como uma extensão do DevTools.
Notificações
Poste mensagens na bandeja do sistema de um usuário usando a API Notifications de extensões ou a API Notifications de plataformas da Web.
Para aprender a usar as notificações, consulte Notificar usuários.
Temas
Um tema é um tipo especial de extensão que muda a aparência do navegador. Os temas são empacotados como extensões comuns, mas não contêm código JavaScript ou HTML.
Para aprender a criar um tema, consulte O que são temas?.
Outras formas de interagir com os usuários
Esta seção descreve outras maneiras de a extensão interagir com os usuários. Embora não sejam estritamente necessários para uma extensão básica, eles podem ser partes importantes dela. Para muitos usuários, alguns desses recursos são absolutamente essenciais para usar a extensão.
Acessibilidade
Para muitos usuários, a acessibilidade é literalmente a interface do usuário, e os recursos dela podem ser úteis para quem não precisa da acessibilidade como principal forma de interagir com a extensão. Aprenda o básico de como tornar sua extensão acessível.
Internacionalização
Fale com os usuários no idioma deles. Saiba como internacionalizar a interface.