Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

O atributo popover

O atributo global `popover` cria um painel inicialmente oculto, apresentado sobre o conteúdo da página. Os valores `auto`, `manual` e `hint` determinam como o painel é fechado.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

popover | popover="" | popover="auto" | popover="manual" | popover="hint"

popover é um atributo global enumerado, não um atributo booleano. O painel começa oculto; quando é aberto, passa para a camada superior (top layer). Se o atributo for omitido, o elemento permanece normal. popover sem valor ou popover="" seleciona auto; um valor inválido, incluindo popover="false", seleciona manual em vez de desativar a funcionalidade.

auto fecha outros popovers automáticos, exceto os popovers ancestrais adequados. A abertura de um popover hint pode fechar outros popovers hint, mantendo abertos os ancestrais relevantes. Se o popover hint tiver um ancestral auto aberto, a sua abertura pode também fechar os popovers auto que estejam acima desse ancestral na pilha. Ambos os modos permitem fechar com um clique fora e aceitam pedidos de fecho, normalmente através de Escape. manual não fecha outros popovers nem reage a estes mecanismos de fecho.

O popovertarget de um botão referencia o id do painel; a ação predefinida alterna a sua visibilidade. popovertargetaction="hide" fecha-o explicitamente. JavaScript também disponibiliza showPopover(), hidePopover() e togglePopover(). Sempre que possível, coloque o painel imediatamente a seguir ao respetivo acionador no DOM, para manter uma ordem de leitura lógica. O atributo não substitui a semântica de acessibilidade adequada ao conteúdo.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Popover example</title>
<button type="button" popovertarget="help">Help</button>
<div id="help" popover="auto">
  Settings are saved automatically.
  <button type="button" popovertarget="help" popovertargetaction="hide">Close</button>
</div>
</html>

Resultado

Initially: Help is visible; the popover is hidden.
Activate Help: Settings are saved automatically. and Close become visible.
Activate Close: the popover is hidden again.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes