Carousel
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) | group com aria-roledescription="carousel"; cada slide é um group com aria-roledescription="slide" |
| Elemento HTML | <section aria-roledescription="carousel" aria-label> com slides <div role="group" aria-roledescription="slide"> |
| Classe / componente | br-carousel |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds.
Nome acessível
O carrossel leva nome ("Carrossel de notícias"); cada slide, "{posição} de {total}" ou o título; botões anterior/próximo levam aria-label. Exemplo: Carrossel de notícias.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, carrossel · slide, {posicao} de {total}
Estados
Em rotação automática
- No código:
aria-live="off" enquanto gira; botão de pausar visível - Acrescenta ao anúncio: em rotação
Slide visível
- No código:
aria-live="polite" quando a troca é manual - Acrescenta ao anúncio: {posicao} de {total}
Teclado
| Tecla | O que faz |
|---|---|
| Tab / Shift+Tab | Move o foco entre botão de pausa, anterior, próximo e conteúdo do slide |
| Enter ou Espaço | Aciona anterior, próximo ou pausa/retoma a rotação |
Para o desenvolvimento
br-carousel (V3). O exemplo do core usa aria-roledescription="carousel"/"slide", role="group", aria-live="polite" em cada slide e botões "Anterior"/"Próximo" com aria-label. A confirmar: o core não mostra botão de pausa; com troca automática ele é obrigatório (WCAG 2.2.2) e o APG manda desligar o aria-live enquanto gira.
Fontes
- DS gov.br V3 · @govbr-ds/core — Carousel (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Carousel Pattern
- WCAG · WCAG 2.2 — 2.2.2 Pausar, parar, ocultar
- eMAG 3.1 · eMAG 3.1 — Recomendação 2.7 (assegurar o controle do usuário sobre as alterações temporais do conteúdo)
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.