Modal
| Versões do DS | V3 |
| Papel (role) | dialog (aria-modal="true") |
| Elemento HTML | <div role="dialog" aria-modal="true" aria-labelledby="id-do-titulo"> |
| Classe / componente | br-modal |
| Origem | Veio 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
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
| Tecla | O que faz |
|---|---|
| Tab / Shift+Tab | Circula só entre os controles do modal (o foco não escapa) |
| Esc | Fecha o modal e devolve o foco ao botão que o abriu |
| Enter ou Espaço | Ativa o botão em foco |
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
- DS gov.br V3 · @govbr-ds/core — Modal (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Dialog (Modal) Pattern
- WCAG · WCAG 2.2 — 2.1.2 Sem armadilha de teclado
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.