Pular para o conteúdo principal

Input

Versões do DSV3 e V4
Papel (role)textbox
Elemento HTML<input type="text">
Classe / componentebr-input
OrigemVeio 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}

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

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​

TeclaO que faz
TabMove o foco para o próximo campo de formulário
Shift+TabRetorna ao campo de formulário anterior
EnterSubmete o formulário (quando dentro de um <form>)
SetasNavegam em campos específicos (ex.: datas, números)
Fonte: documentação do DS gov.br (V4).

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​

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.