Pular para o conteúdo principal

Upload

A confirmar

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 DSV3
Papel (role)button (aciona o seletor de arquivos) + lista de arquivos
Elemento HTML<input type="file"> com <label> ou <button> que o aciona
Classe / componentebr-upload
OrigemA 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}

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​

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​

TeclaO que faz
EnterAtiva o controle em foco
EspaçoAtiva botões e alterna controles
Tab / Shift+TabMove o foco para o controle seguinte / anterior
Fonte: curadoria (WAI-ARIA APG).

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​

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.