Ir para o conteúdo

Carousel

Carrossel de slides com gestos de toque e controles de anterior e próximo.

Navegadores
Chrome 123+Firefox 121+Safari 17.5+
Nível
2
Tamanho compactado
7.17 kB
Limite de layout forçado
0 ms
Limite do axe
0
Compatível com SSR
Sim
Contrato publicado
Ambiente de teste

Experimentar

Carousel

Cartões em destaque

Navegue entre as histórias com as setas ou selecione um slide pelos pontos.

Faixa responsiva de cartões

Da direita para a esquerda

Eixo de bloco

Controles sincronizados e comandos nativos

Reprodução automática com Parar e Iniciar

O foco interrompe a rotação até você pressionar Iniciar. Passar o ponteiro pausa temporariamente.

Arraste opcional com mouse

Transição de opacidade com CSS

API

Carousel

CarouselClient — @gunkin/uiify/components/carousel/client

PropTipoPadrãoDescrição
defaultValue / valuenumber—Índice inicial ou controlado do item; o estado observado após o fim do movimento orienta os controles.
rewindbooleanfalseVolte à outra extremidade sem clonar slides.
mouseDragbooleanfalseArraste com mouse opcional. Toque e roda do mouse continuam nativos.
autoplayboolean | CarouselAutoplayOptionsfalseO atraso padrão é 5000ms. Opções: delay, paused, cycles e stopOnInteraction. Inclui Parar/Iniciar visíveis.
onSelect / beforeChange / afterChange / onSwipecallbacks—Informe alterações efetivamente concluídas e seus motivos; veja no guia de Carousel a semântica de controle e de movimentos interrompidos.
refRef<CarouselClientHandle>—next, previous, goTo, start, stop e reset.

FadeCarouselClient — @gunkin/uiify/components/carousel/fade

PropTipoPadrãoDescrição
swipebooleantrueGesto com toque/caneta; mouse exige mouseDrag. Herda as props de cliente, exceto axis. Slides inativos são inertes.

Teclado

TeclaAção
Tab / EnterFoque e siga links nativos de slides; os botões aprimorados também são ativados com Space
Arrow keysUse a rolagem nativa enquanto a área visível estiver em foco

Acessibilidade

O Carousel base é um componente de servidor com rolagem nativa, encaixe e navegação finita por fragmentos. A entrada interativa /client é Tier 2: pontos sincronizados, setas persistentes, callbacks, reprodução automática e arraste com mouse exigem hidratação; /fade acrescenta transições de opacidade em CSS. O foco interrompe a reprodução automática até Iniciar; passar o ponteiro pausa temporariamente, e movimento reduzido desativa a rotação automática por padrão. O laboratório de controles gerados por CSS é experimental.

Pontos de integração de estilos

data-uiify-carouseldata-axisdata-enhanceddata-modedata-carousel-indexdata-statedata-dragging--uiify-carousel-slide-size--uiify-carousel-gap--uiify-carousel-fade-duration