Select
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 | V3 e V4 |
| Papel (role) | combobox (select nativo) · listbox quando a lista está aberta |
| Elemento HTML | <select> com <label> |
| Classe / componente | br-select |
| Origem | Veio 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}
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
| Tecla | O que faz |
|---|---|
| Tab | Move o foco para o campo select |
| Enter/Espaço | Abre ou fecha a lista de opções |
| Setas | Navegam entre as opções da lista aberta |
| Enter/Espaço | Seleciona a opção em foco |
| Esc | Fecha a lista sem alterar a seleção |
| Shift+Tab | Retorna ao elemento anterior |
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
- DS gov.br V4 · next-ds — Select, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Select (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Select-Only Combobox Example
- W3C HTML-AAM · HTML-AAM — elemento select
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.