Radio
| Versões do DS | V3 e V4 |
| Papel (role) | radio dentro de radiogroup |
| Elemento HTML | <fieldset><legend> com <input type="radio"> e <label> |
| Classe / componente | br-radio |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds · next-ds.
Nome acessível
Cada opção: o rótulo ligado ao input. O grupo: a legenda (legend) ou aria-labelledby no radiogroup. Exemplo: Sexo: Feminino.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, botão de opção, {posicao} de {total}{estado}
Estados
Selecionado
- No código:
checked (nativo) ou aria-checked="true" - Acrescenta ao anúncio: selecionado / não selecionado
Com erro
- No código:
aria-invalid="true" e aria-describedby apontando para a mensagem - Acrescenta ao anúncio: inválido, {mensagem}
Obrigatório
- No código:
required (ou aria-required="true") - Acrescenta ao anúncio: obrigatório
Desabilitado
- No código:
disabled - Acrescenta ao anúncio: indisponível
Teclado
| Tecla | O que faz |
|---|---|
| Tab | Move o foco para o grupo de botões de rádio |
| Setas | Movem o foco e alteram a seleção entre as opções do grupo |
| Espaço | Seleciona a opção em foco |
| Shift+Tab | Retorna ao elemento anterior |
Para o desenvolvimento
br-radio (V3) / <br-radio-group> (V4, id "radio-group" na base). Tab entra no grupo (uma parada); setas movem e selecionam. Todos os inputs do grupo com o mesmo name. Legenda do grupo obrigatória.
Fontes
- DS gov.br V4 · next-ds — Radio Group, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Radio (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Radio Group Pattern
- eMAG 3.1 · eMAG 3.1 — Recomendação 6.7 (agrupar campos de formulário)
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.