rating
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 | V4 |
| Papel (role) | radiogroup com radio em cada marcador |
| Elemento HTML | <div role="radiogroup" aria-labelledby> com <input type="radio"> e <label> |
| Classe / componente | — |
| Origem | A 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}
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
| Tecla | O que faz |
|---|---|
| Tab | Move o foco para o grupo de Marcadores de Avaliação |
| Shift+Tab | Retorna 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ço | Confirma a seleção e registra o voto da opção em foco; um segundo acionamento sobre a opção já selecionada desfaz o voto |
| Escape | Cancela a interação quando aplicável (ex.: remove o foco do grupo sem registrar voto) |
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
- DS gov.br V4 · next-ds — Rating, acessibilidade
- W3C WAI-ARIA APG · WAI-ARIA APG — Radio Group Pattern
- WCAG · WCAG 2.2 — 4.1.2 Nome, função, valor
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.