Pular para o conteúdo principal

Textarea

Versões do DSV3
Papel (role)textbox (multilinha)
Elemento HTML<textarea> com <label>
Classe / componentebr-textarea
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: gov.br/ds.

Nome acessível​

O rótulo ligado por for/id; aria-label só sem rótulo visível (o core aceita aria-label no textarea). Exemplo: Descreva o problema.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): {nome}, campo de edição com várias linhas{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

Contador de caracteres​

  • No código: aria-describedby para o contador; contador em aria-live="polite" (role="status")
  • Acrescenta ao anúncio: {restantes} caracteres restantes

Limite excedido​

  • No código: aria-live="assertive" na mensagem de limite; aria-invalid="true"
  • Acrescenta ao anúncio: limite de caracteres excedido

Teclado​

TeclaO que faz
Tab / Shift+TabEntra e sai do campo (Tab não insere tabulação)
EnterInsere quebra de linha
Fonte: curadoria (WAI-ARIA APG).

Para o desenvolvimento​

br-textarea (V3). O contador do core usa role="status" e aria-live="polite" e a mensagem de limite aria-live="assertive", com aria-controls para o elemento do limite. Evite anunciar o contador a cada tecla: avise ao se aproximar do limite.

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.