Ir al contenido

Carousel

Carrusel de diapositivas con gestos táctiles y controles anterior y siguiente.

Navegadores
Chrome 123+Firefox 121+Safari 17.5+
Nivel
2
Tamaño comprimido
7.17 kB
Presupuesto de diseño forzado
0 ms
Presupuesto de axe
0
Compatible con SSR
Sí
Contrato publicado
Entorno de pruebas

Zona de pruebas

Carousel

Tarjetas destacadas

Recorre las historias con las flechas o elige una diapositiva con los puntos.

Fila adaptable de tarjetas

De derecha a izquierda

Eje de bloque

Controles sincronizados y comandos nativos

Reproducción automática con inicio y detención

El foco detiene la rotación hasta presionar Iniciar. Pasar el puntero la pausa temporalmente.

Arrastre con mouse opcional

Fundido con transiciones CSS

API

Carousel

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

PropTipoPredeterminadoDescripción
defaultValue / valuenumber—Índice de elemento inicial o controlado; el estado observado al terminar el movimiento determina los controles.
rewindbooleanfalseVuelve al otro extremo al llegar al final, sin clonar diapositivas.
mouseDragbooleanfalseArrastre con mouse opcional. El tacto y la rueda siguen siendo nativos.
autoplayboolean | CarouselAutoplayOptionsfalseLa espera predeterminada es 5000ms. Opciones: delay, paused, cycles y stopOnInteraction. Incluye controles visibles para detener e iniciar.
onSelect / beforeChange / afterChange / onSwipecallbacks—Informa los cambios reales al terminar el movimiento y sus motivos; consulta la guía de Carousel para la semántica del control y de los movimientos interrumpidos.
refRef<CarouselClientHandle>—next, previous, goTo, start, stop y reset.

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

PropTipoPredeterminadoDescripción
swipebooleantrueDeslizamiento táctil o con lápiz; el mouse requiere mouseDrag. Hereda las props de cliente salvo axis. Las diapositivas inactivas son inertes.

Teclado

TeclaAcción
Tab / EnterDar el foco y seguir enlaces nativos de diapositivas; los botones mejorados también se activan con Space
Arrow keysUsar el desplazamiento nativo mientras el área visible tiene el foco

Accesibilidad

El Carousel base es un componente de servidor con desplazamiento nativo, ajuste y navegación finita por fragmentos. La entrada interactiva /client es Tier 2: los puntos sincronizados, las flechas persistentes, los callbacks, la reproducción automática y el arrastre con mouse requieren hidratación; /fade añade transiciones de opacidad CSS. El foco detiene la reproducción automática hasta activar el control de inicio, pasar el puntero la pausa temporalmente y el movimiento reducido desactiva la rotación automática de forma predeterminada. El laboratorio de controles generados con CSS es experimental.

Puntos de estilo

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