Upload
Nenhuma fonte cobre tudo deste componente: o ponto em aberto está na seção "Para o desenvolvimento". Se você testou na implementação, conte o que viu nos comentários.
| Versões do DS | V3 |
| Papel (role) | button (aciona o seletor de arquivos) + lista de arquivos |
| Elemento HTML | <input type="file"> com <label> ou <button> que o aciona |
| Classe / componente | br-upload |
| Origem | A documentação do DS não cobre o essencial: completado pela curadoria com o padrão do W3C (WAI-ARIA APG) e o eMAG. |
Documentação oficial: gov.br/ds.
Nome acessível
O rótulo do campo e do botão ("Enviar arquivo"); cada arquivo listado leva nome e botão de remover com o nome do arquivo. Exemplo: Enviar arquivo.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, botão{estado}
Estados
Arquivo(s) selecionado(s)
- No código:
região viva aria-live="polite" com o nome e a quantidade - Acrescenta ao anúncio: {n} arquivo selecionado: {nome}
Erro de tipo ou tamanho
- No código:
aria-invalid e mensagem em aria-describedby / alert - Acrescenta ao anúncio: erro: {mensagem}
Enviando
- No código:
barra com role="progressbar" e nome - Acrescenta ao anúncio: enviando
Teclado
| Tecla | O que faz |
|---|---|
| Enter | Ativa o controle em foco |
| Espaço | Ativa botões e alterna controles |
| Tab / Shift+Tab | Move o foco para o controle seguinte / anterior |
Para o desenvolvimento
br-upload (V3). O core usa um input escondido acionado por botão com aria-label "enviar arquivo". Arrastar e soltar não pode ser o único modo. Informe formatos e tamanho máximo em texto antes do envio. A confirmar: o HTML-AAM não dá papel ao input de arquivo (sem papel correspondente), então o anúncio varia por leitor; teste com os leitores do projeto.
Fontes
- DS gov.br V3 · @govbr-ds/core — Upload (documentação e código de exemplo)
- W3C HTML-AAM · HTML-AAM — input type=file
- WCAG · WCAG 2.2 — 4.1.3 Mensagens de status
- eMAG 3.1 · eMAG 3.1 — Recomendação 6.5 (fornecer instruções para entrada de dados)
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.