Pular para o conteúdo principal

Tag

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 e V4
Papel (role)sem papel (texto) · button quando selecionável ou removível
Elemento HTML<span> (estática) · <button> (interativa)
Classe / componentebr-tag
OrigemVeio 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}

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​

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​

TeclaO que faz
EnterAtiva a Tag, quando ela for interativa
EspaçoAtiva a Tag, quando aplicável
TabNavega para a próxima Tag ou elemento interativo
Shift+TabNavega para a Tag ou elemento interativo anterior
SetasPermitem a leitura sequencial do conteúdo pelo leitor de tela, conforme o modo de navegação e a tecnologia assistiva utilizada
Fonte: documentação do DS gov.br (V4).

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​

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.