Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é popover?

    Um popover exibe conteúdo temporário acima da página. A API HTML controla a abertura e o fechamento, mas o painel ainda precisa de semântica acessível.

    Também chamado de: painel popover, Popover API

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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.

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano