Pular para o conteúdo principal

form-label

Versões do DSV4
Papel (role)sem papel próprio (nomeia o controle associado)
Elemento HTML<label for="id-do-campo">
Classe / componente—
OrigemVeio 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}

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​

Obrigatório​

  • No código: required (ou aria-required="true")
  • Acrescenta ao anúncio: obrigatório

Teclado​

TeclaO que faz
TabMove o foco para o próximo campo de formulário associado ao rótulo
Shift+TabRetorna ao campo de formulário anterior
Espaço/EnterAtiva botões, caixas de seleção ou outros controles associados
Fonte: documentação do DS gov.br (V4).

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​

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.