Pular para o conteúdo principal

rating

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 DSV4
Papel (role)radiogroup com radio em cada marcador
Elemento HTML<div role="radiogroup" aria-labelledby> com <input type="radio"> e <label>
Classe / componente—
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: next-ds.

Nome acessível​

O grupo é nomeado pelo Texto Auxiliar ("Avalie este serviço"); cada marcador tem nome próprio ("4 estrelas — Bom"), pois o rótulo visual só aparece nos extremos. Exemplo: 4 estrelas — Bom.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): {nome}, {posicao} de {total}{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​

Selecionado / removido​

  • No código: checked; acionar de novo a opção marcada limpa o voto
  • Acrescenta ao anúncio: 4 estrelas — Bom, {posicao} de {total}, selecionado / não selecionado

Cumulativo (tipo Qualidade)​

  • No código: cada marcador preenchido deve expor seu estado correto, não só o último clicado
  • Acrescenta ao anúncio: selecionado / não selecionado

Teclado​

TeclaO que faz
TabMove o foco para o grupo de Marcadores de Avaliação
Shift+TabRetorna ao elemento interativo anterior
Setas (direita/esquerda)Navega entre os Marcadores de Avaliação dentro do grupo e altera a seleção
Enter ou EspaçoConfirma a seleção e registra o voto da opção em foco; um segundo acionamento sobre a opção já selecionada desfaz o voto
EscapeCancela a interação quando aplicável (ex.: remove o foco do grupo sem registrar voto)
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

<br-rating> (V4 apenas). Os papéis (radiogroup/radio) vêm do padrão de grupo de rádio, que a base V4 descreve só pelo resultado esperado. A confirmar: limpar o voto ao reativar a opção não é comportamento nativo de radio e exige tratamento e anúncio próprios.

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.