form-label
| Versões do DS | V4 |
| Papel (role) | sem papel próprio (nomeia o controle associado) |
| Elemento HTML | <label for="id-do-campo"> |
| Classe / componente | — |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: next-ds.
Nome acessível
É o próprio nome do campo: texto claro ligado por for/id ou por encapsulamento. A obrigatoriedade deve vir em texto ("obrigatório"), não só em asterisco. Exemplo: Nome completo (obrigatório).
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): (anunciado como nome do campo) {nome}, campo de edição{estado}
Estados
Obrigatório
- No código:
required (ou aria-required="true") - Acrescenta ao anúncio: obrigatório
Teclado
| Tecla | O que faz |
|---|---|
| Tab | Move o foco para o próximo campo de formulário associado ao rótulo |
| Shift+Tab | Retorna ao campo de formulário anterior |
| Espaço/Enter | Ativa botões, caixas de seleção ou outros controles associados |
Para o desenvolvimento
<br-form-label> (V4 apenas). Deve existir em cada campo; placeholder não substitui. Toda instrução adicional (formato, ajuda) entra via aria-describedby no campo.
Fontes
- DS gov.br V4 · next-ds — Form Label, acessibilidade
- eMAG 3.1 · eMAG 3.1 — Recomendação 6.2 (associar etiquetas aos seus campos)
- WCAG · WCAG 2.2 — 3.3.2 Rótulos ou instruções
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.