icon
| Versões do DS | V4 |
| Papel (role) | img (ícone com significado) · presentation (decorativo) |
| Elemento HTML | <svg role="img" aria-label> ou <i aria-hidden="true"> |
| Classe / componente | — |
| Origem | Veio 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)
Estados
Decorativo
- No código:
aria-hidden="true" - Acrescenta ao anúncio: (ignorado)
Teclado
| Tecla | O que faz |
|---|---|
| Tab | Move o foco para o próximo ícone interativo ou botão associado |
| Shift+Tab | Retorna ao ícone ou botão anterior |
| Enter/Espaço | Ativa o botão ou ação associada ao ícone |
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
- DS gov.br V4 · next-ds — Ícones, acessibilidade
- eMAG 3.1 · eMAG 3.1 — Recomendação 3.6 (fornecer alternativa em texto para as imagens do sítio)
- W3C WAI-ARIA APG · WAI-ARIA APG — Hiding semantics with presentation role
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.