Pular para o conteúdo principal

Select

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)combobox (select nativo) · listbox quando a lista está aberta
Elemento HTML<select> com <label>
Classe / componentebr-select
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: gov.br/ds · next-ds.

Nome acessível​

O rótulo ligado por for/id; aria-label ou aria-labelledby só sem rótulo visível. Exemplo: Estado.

O que é anunciado​

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

Lista aberta / fechada​

  • No código: aria-expanded="true|false" (nativo no <select>)
  • Acrescenta ao anúncio: expandido / recolhido

Obrigatório​

  • No código: required (ou aria-required="true")
  • Acrescenta ao anúncio: obrigatório

Com erro​

  • No código: aria-invalid="true" e aria-describedby apontando para a mensagem
  • Acrescenta ao anúncio: inválido, {mensagem}

Desabilitado​

  • No código: disabled
  • Acrescenta ao anúncio: indisponível

Teclado​

TeclaO que faz
TabMove o foco para o campo select
Enter/EspaçoAbre ou fecha a lista de opções
SetasNavegam entre as opções da lista aberta
Enter/EspaçoSeleciona a opção em foco
EscFecha a lista sem alterar a seleção
Shift+TabRetorna ao elemento anterior
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

br-select (V3) / <br-select> (V4). Prefira o <select> nativo. Na V3 o br-select é um widget montado com JavaScript e o código de exemplo do core traz apenas tabindex, sem papéis ARIA: confirme com leitor de tela se a lista é exposta como listbox/option e se o valor escolhido é anunciado. Lista com busca segue o padrão select-only combobox.

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.