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

CKTIS / HTML

aria-modal — semântica de diálogos modais

O atributo aria-modal informa as tecnologias de apoio se um elemento apresentado é modal, ou seja, se a interação fica limitada ao seu conteúdo. Por si só, não bloqueia o fundo nem gere o foco: a declaração tem de corresponder ao comportamento real da interface.

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

Sintaxe

aria-modal="true" | aria-modal="false"

aria-modal é uma propriedade WAI-ARIA utilizada em HTML para indicar se um elemento apresentado é modal. O valor true indica modalidade; false é o valor predefinido. Esta propriedade aceita os valores de texto true e false e não segue a sintaxe dos atributos booleanos de HTML: não escreva o nome do atributo sem um valor. É suportada nas funções dialog e alertdialog, não globalmente em elementos arbitrários.

aria-modal="true" comunica semântica às tecnologias de apoio, que podem restringir a navegação ao conteúdo do diálogo. Não abre um diálogo, não bloqueia cliques no fundo e não move nem mantém o foco. Defina este valor apenas quando a interface impede realmente que todas as pessoas interajam com conteúdo fora do diálogo e o fundo está visualmente escurecido ou oculto.

Ao abrir, mova o foco para dentro do diálogo e mantenha aí a sequência de Tab e Shift+Tab. Disponibilize um botão de fecho no interior e suporte Escape; ao fechar, restaure normalmente o foco ao elemento que o acionou. Dê ao diálogo um nome acessível, por exemplo através de aria-labelledby que faça referência ao título visível. Todos os controlos necessários para utilizar o diálogo têm de ser seus descendentes.

O exemplo utiliza um diálogo nativo aberto com showModal(), em vez de recriar manualmente o comportamento modal. Neste caso, aria-modal="true" é redundante, porque a modalidade nativa já é exposta às tecnologias de apoio; mantém-se para demonstrar a sintaxe. Adicionar o atributo, por si só, a um contentor comum não proporciona este comportamento. Verifique separadamente o funcionamento com teclado e a semântica na árvore de acessibilidade.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-modal example</title>
<style>
  dialog::backdrop { background: rgb(0 0 0 / 50%); }
</style>
<button id="open" type="button">Open dialog</button>
<dialog id="notice" aria-modal="true" aria-labelledby="heading">
  <h2 id="heading">Notice</h2>
  <p>This dialog blocks interaction with the page.</p>
  <button id="close" type="button" autofocus>Close</button>
</dialog>
<script>
  const opener = document.getElementById('open');
  const notice = document.getElementById('notice');
  const closer = document.getElementById('close');
  opener.addEventListener('click', () => notice.showModal());
  closer.addEventListener('click', () => notice.close());
  notice.addEventListener('close', () => opener.focus());
</script>
</html>

Resultado

Initially, only Open dialog is visible. Activating it opens Notice, dims the background, and focuses Close. Background controls cannot be activated while the dialog is open. Close or Escape dismisses the dialog and returns focus to Open dialog.

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