Tag
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 e V4 |
| Papel (role) | sem papel (texto) · button quando selecionável ou removível |
| Elemento HTML | <span> (estática) · <button> (interativa) |
| Classe / componente | br-tag |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds · next-ds.
Nome acessível
O texto visível. Tag interativa: o nome acessível contém o rótulo visível; botão de remover diz qual tag remove. Exemplo: Prioridade alta.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}{estado} · {nome}, botão{estado}
Estados
Selecionada (tag de seleção)
- No código:
aria-pressed="true|false" no botão - Acrescenta ao anúncio: pressionado / não pressionado
Removível
- No código:
botão com aria-label "Remover {rótulo}" - Acrescenta ao anúncio: botão, remover {rótulo}
Desabilitado
- No código:
disabled - Acrescenta ao anúncio: indisponível
Teclado
| Tecla | O que faz |
|---|---|
| Enter | Ativa a Tag, quando ela for interativa |
| Espaço | Ativa a Tag, quando aplicável |
| Tab | Navega para a próxima Tag ou elemento interativo |
| Shift+Tab | Navega para a Tag ou elemento interativo anterior |
| Setas | Permitem a leitura sequencial do conteúdo pelo leitor de tela, conforme o modo de navegação e a tecnologia assistiva utilizada |
Para o desenvolvimento
br-tag (V3) / <br-tag> (V4). O significado (estado, categoria) não pode depender só da cor. Os exemplos do core usam aria-describedby para relacionar a tag ao seu texto e aria-label="Fechar" no botão de remover; prefira "Remover {rótulo}" para o botão dizer o que remove. A confirmar: o atributo exato de estado de seleção (a base não o define).
Fontes
- DS gov.br V4 · next-ds — Tag, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Tag (documentação e código de exemplo)
- WCAG · WCAG 2.2 — 1.4.1 Uso de cor
- WCAG · WCAG 2.2 — 2.5.3 Rótulo no nome
- W3C WAI-ARIA APG · WAI-ARIA APG — Button Pattern (aria-pressed)
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.