Pular para o conteúdo principal

Carousel

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
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 / componentebr-carousel
OrigemVeio 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}

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​

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​

TeclaO que faz
Tab / Shift+TabMove o foco entre botão de pausa, anterior, próximo e conteúdo do slide
Enter ou EspaçoAciona anterior, próximo ou pausa/retoma a rotação
Fonte: curadoria (WAI-ARIA APG).

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​

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.