O painel e o mecanismo do navegador
Um popover é um painel temporário exibido sobre o conteúdo da página. Ele pode apresentar informações ou controles ligados a uma ação, como um botão que abre links de navegação. A Popover API permite controlar essa exibição com atributos HTML ou métodos JavaScript.
Um elemento com o atributo popover fica oculto até ser aberto. Quando aparece, o navegador o coloca na camada superior de exibição, chamada top layer. Essa camada fica acima do conteúdo comum da página, inclusive dos elementos que usam valores altos de z-index.
Um botão que abre links
O exemplo didático associa um botão a um painel pelo identificador referencias. Ele usa links comuns para abrir o glossário e a documentação:
<button type="button" popovertarget="referencias">Referências</button><nav id="referencias" popover="auto" aria-label="Referências técnicas"> <a href="/glossario/">Glossário</a> <a href="/docs/">Documentação</a></nav>O atributo popovertarget associa o botão ao painel pelo mesmo identificador, para que acionar o botão alterne a exibição da navegação. O modo auto também permite fechar o painel com um clique externo ou com Escape. Você pode testar a abertura com o teclado e seguir até os links com Tab.
O atributo popover controla a exibição, mas não transforma essa navegação num menu com setas do teclado. O exemplo conserva os elementos de link e a identificação da navegação. Um componente com role="menu" exigiria a implementação das interações próprias de menu.
Fechamento e interação com a página
O modo manual mantém o painel aberto mesmo com clique externo ou Escape. Nesse modo, a aplicação precisa oferecer uma forma de fechá-lo, como um botão associado ao painel ou uma chamada a hidePopover(). A especificação também prevê o modo hint: abrir um desses painéis pode fechar outro hint, preservando os popovers auto abertos.
Os popovers dessa API são não modais: abrir o painel não torna o restante da página indisponível. Para uma interação que precisa restringir o foco ao diálogo, você deve avaliar um diálogo modal. A semântica do conteúdo e o percurso do foco continuam exigindo conferência, mesmo com a exibição controlada pelo navegador.
Dúvidas frequentes
Perguntas frequentes sobre popover
- Um popover impede a interação com o restante da página?
- Os popovers da API HTML são não modais. A página continua disponível para interação, por isso o atributo popover não substitui um diálogo modal.
- Qual é a diferença entre auto e manual?
- O modo auto permite dispensar o painel com clique externo ou Escape. No modo manual, essas ações não o fecham automaticamente. Você precisa oferecer um botão de fechamento ou chamar hidePopover().
- Todo popover precisa usar role="menu"?
- O papel depende do conteúdo. Uma lista comum de links pode conservar sua semântica de navegação. Um menu com role="menu" exige também o comportamento de teclado próprio desse padrão.
Para continuar
Recursos relacionados
Documentação
MDN: Popover API
Visão geral da Popover API, com os atributos HTML e métodos usados para controlar a exibição.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para você implementar um painel sobreposto e conferir sua abertura e navegação por teclado.
Abrir recursoDocumentação
WHATWG: atributo popover no HTML
Especificação dos modos de exibição, dos botões associados e das responsabilidades de acessibilidade.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A implementação de um painel sobreposto exige conferir sua exibição e o percurso do foco pelo teclado.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.