Pular para o conteúdo principal

Modal

Versões do DSV3
Papel (role)dialog (aria-modal="true")
Elemento HTML<div role="dialog" aria-modal="true" aria-labelledby="id-do-titulo">
Classe / componentebr-modal
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: gov.br/ds.

Nome acessível​

O título do modal, ligado por aria-labelledby; botão de fechar com aria-label "Fechar". Exemplo: Confirmar exclusão.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): {nome}, caixa de diálogo

Comportamento esperado, não a fala exata: NVDA, JAWS, VoiceOver e TalkBack variam. No plugin, cada elemento tem um campo para o resultado do teste com leitor de tela real.

Estados​

Aberto​

  • No código: role="dialog" aria-modal="true"; conteúdo de fundo inerte
  • Acrescenta ao anúncio: {nome}, caixa de diálogo

Teclado​

TeclaO que faz
Tab / Shift+TabCircula só entre os controles do modal (o foco não escapa)
EscFecha o modal e devolve o foco ao botão que o abriu
Enter ou EspaçoAtiva o botão em foco
Fonte: curadoria (WAI-ARIA APG).

Para o desenvolvimento​

br-modal (V3), com scrim. O código do core usa role="dialog", aria-modal="true" e aria-labelledby apontando para o título (todos os exemplos). Ao abrir, o foco vai para o primeiro controle útil (ou o título); ao fechar, volta ao gatilho. O fundo fica inerte (inert ou aria-hidden).

Fontes​

Comentários e evolução

Viu algo a corrigir ou completar nesta especificação? Comente abaixo dizendo qual parte, o que mudar e a fonte (WCAG, eMAG, WAI-ARIA APG, documentação do DS gov.br ou teste com leitor de tela). É preciso uma conta no GitHub. As sugestões aceitas entram na base e aparecem nas Novidades.