Textarea
| Versões do DS | V3 |
| Papel (role) | textbox (multilinha) |
| Elemento HTML | <textarea> com <label> |
| Classe / componente | br-textarea |
| Origem | Veio 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}
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
| Tecla | O que faz |
|---|---|
| Tab / Shift+Tab | Entra e sai do campo (Tab não insere tabulação) |
| Enter | Insere quebra de linha |
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
- DS gov.br V3 · @govbr-ds/core — Textarea (documentação e código de exemplo)
- W3C HTML-AAM · HTML-AAM — elemento textarea
- eMAG 3.1 · eMAG 3.1 — Recomendação 6.2 (associar etiquetas aos seus campos)
- WCAG · WCAG 2.2 — 4.1.3 Mensagens de status
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.