Pular para o conteúdo principal

icon

Versões do DSV4
Papel (role)img (ícone com significado) · presentation (decorativo)
Elemento HTML<svg role="img" aria-label> ou <i aria-hidden="true">
Classe / componente—
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: next-ds.

Nome acessível​

Ícone sozinho que faz uma ação ou informa algo leva texto alternativo; ícone ao lado de texto que diz o mesmo é decorativo. Exemplo: Excluir.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): {nome}, imagem · (ignorado se decorativo)

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​

Decorativo​

  • No código: aria-hidden="true"
  • Acrescenta ao anúncio: (ignorado)

Teclado​

TeclaO que faz
TabMove o foco para o próximo ícone interativo ou botão associado
Shift+TabRetorna ao ícone ou botão anterior
Enter/EspaçoAtiva o botão ou ação associada ao ícone
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

<br-icon> (V4 apenas). No V3 os ícones são Font Awesome em <i class="fas …"> sempre com aria-hidden="true". Se o ícone está dentro de botão ou link, o nome vai no botão/link, não no ícone.

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.