Input
| Versões do DS | V3 e V4 |
| Papel (role) | textbox |
| Elemento HTML | <input type="text"> |
| Classe / componente | br-input |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds · next-ds.
Nome acessível
O rótulo (label) ligado ao campo por for/id; aria-label ou aria-labelledby só quando não há rótulo visível. Exemplo: CPF.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, campo de edição{estado}
Estados
Obrigatório
- No código:
required (ou aria-required="true") - Acrescenta ao anúncio: obrigatório
Com erro
- No código:
aria-invalid="true" e aria-describedby apontando para a mensagem - Acrescenta ao anúncio: inválido, {mensagem}
Desabilitado
- No código:
disabled - Acrescenta ao anúncio: indisponível
Com texto de ajuda
- No código:
aria-describedby apontando para o texto - Acrescenta ao anúncio: {ajuda}
Teclado
| Tecla | O que faz |
|---|---|
| Tab | Move o foco para o próximo campo de formulário |
| Shift+Tab | Retorna ao campo de formulário anterior |
| Enter | Submete o formulário (quando dentro de um <form>) |
| Setas | Navegam em campos específicos (ex.: datas, números) |
Para o desenvolvimento
Use <div class="br-input"> com <label> ligado ao <input> (V3) ou <br-input> (V4). Mensagem de erro ligada por aria-describedby e anunciada ao aparecer.
Fontes
- DS gov.br V4 · next-ds — Input, acessibilidade
- DS gov.br V3 · gov.br/ds — Input
- eMAG 3.1 · eMAG 3.1 — Recomendação 6.2 (rótulos em campos de formulário)
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.