Pular para o conteúdo principal

Radio

Versões do DSV3 e V4
Papel (role)radio dentro de radiogroup
Elemento HTML<fieldset><legend> com <input type="radio"> e <label>
Classe / componentebr-radio
OrigemVeio 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}

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​

  • 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​

TeclaO que faz
TabMove o foco para o grupo de botões de rádio
SetasMovem o foco e alteram a seleção entre as opções do grupo
EspaçoSeleciona a opção em foco
Shift+TabRetorna ao elemento anterior
Fonte: documentação do DS gov.br (V4).

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​

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.