Tab
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 |
| Papel (role) | tablist, tab e tabpanel |
| Elemento HTML | <ul role="tablist"><li role="presentation"><button role="tab" aria-selected aria-controls> + <div role="tabpanel" aria-labelledby> |
| Classe / componente | br-tab |
| 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: gov.br/ds.
Nome acessível
O texto da aba; aba só com ícone leva aria-label (o exemplo do core usa); cada painel é nomeado pela aba. Exemplo: Documentos.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, guia, {posicao} de {total}{estado}
Estados
Selecionada
- No código:
aria-selected="true|false" - Acrescenta ao anúncio: selecionada
Desabilitado
- No código:
aria-disabled="true" - Acrescenta ao anúncio: indisponível
Teclado
| Tecla | O que faz |
|---|---|
| Tab | Entra na lista de abas (só a aba ativa é parada) e depois no painel |
| ← / → | Movem entre as abas |
| Home / End | Primeira / última aba |
| Enter ou Espaço | Ativa a aba, se a ativação não for automática |
Para o desenvolvimento
br-tab (V3). O código de exemplo do core mostra <button> dentro de tab-item com aria-label nas abas de ícone; os papéis tab/tablist/tabpanel e aria-selected não aparecem no código e dependem do JavaScript do core. A confirmar no navegador: se são aplicados e se as setas funcionam.
Fontes
- DS gov.br V3 · @govbr-ds/core — Tab (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Tabs 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.