A responsive modern carousel slider for the Gutenberg block editor that lets you add any blocks to your slides.
🚀 Carousel Slider Version 2 is built on the modern Swiper.js library for improved performance and compatibility.
Características
- Añade diapositivas ilimitadas
- Añadie cualquier bloque a las diapositivas
- Vista previa del carrusel en el editor
- Adaptable y compatible con toques
Ajustes
- Diapositivas por vista
- Diapositivas que hacen scroll al mismo tiempo
- Velocidad de desplazamiento
- Relleno de diapositivas
- Flechas de anterior/siguiente
- Navegación por puntos
- Blucle de diapositivas infinito
- Reproducción automática
- Ajustes de adaptabilidad: diapositivas a mostrar y hacer scroll en un tamaño de pantalla dado
- RTL
Requisitos
Recomendamos PHP 5.6+, WordPress 5.8+, con Gutenberg activo.
Documentación
Selecciona el bloque de carrusel de diapositivas desde la categoría de diseño. Haz clic en el botón + situado al final del carrusel para añadir diapositivas. Añade cualquier bloque dentro de las diapositivas. Usa la barra de desplazamiento horizontal para previsualizar las diapositivas en el editor.
Puedes reordenar las diapositivas usando los botones de flecha izquierda y derecha de la barra de herramientas.
Para quitar una diapositiva selecciona la diapositiva y haz clic en los tres puntos de la derecha sobre la misma. Haz clic en la opción de eliminar esa diapositiva.
Haz clic en el bloque de carrusel (el bloque que anida todas las diapositivas) para mostrar los ajustes del carrusel.
Upgrading from Legacy Carousel
See the support topic for upgrading legacy blocks to Carousel Slider Version 2.
Customizing v2 Styles
Carousel Slider v2 supports custom styling via CSS variables:
Navigation
--wp--custom--carousel-block--navigation-size: Arrow icon size--wp--custom--carousel-block--navigation-sides-offset: Distance from edge--wp--custom--carousel-block--navigation-color: Arrow color--wp--custom--carousel-block--navigation-hover-color: Arrow hover color (falls back tonavigation-color)--wp--custom--carousel-block--navigation-alignfull-color: Arrow color when carousel is full width
Pagination (dots)
--wp--custom--carousel-block--pagination-top: Top offset--wp--custom--carousel-block--pagination-bottom: Bottom offset--wp--custom--carousel-block--pagination-bullet-size: Bullet size--wp--custom--carousel-block--pagination-bullet-active-color: Active bullet color--wp--custom--carousel-block--pagination-bullet-inactive-color: Inactive bullet color--wp--custom--carousel-block--pagination-bullet-inactive-hover-color: Inactive bullet hover color (falls back toactive-colorif set)--wp--custom--carousel-block--pagination-bullet-active-opacity: Active bullet opacity--wp--custom--carousel-block--pagination-bullet-inactive-opacity: Inactive bullet opacity--wp--custom--carousel-block--pagination-bullet-inactive-hover-opacity: Inactive bullet opacity on hover (falls back toinactive-opacityif not set)--wp--custom--carousel-block--pagination-bullet-horizontal-gap: Space between bullets (horizontal)--wp--custom--carousel-block--pagination-bullet-vertical-gap: Space between bullets (vertical)
Block Spacing
--wp--custom--carousel-block--image-margin-top: Top margin for image blocks--wp--custom--carousel-block--image-margin-bottom: Bottom margin for image blocks--wp--custom--carousel-block--cover-margin-top: Top margin for cover blocks--wp--custom--carousel-block--cover-margin-bottom: Bottom margin for cover blocks
Theme JSON Support
All the CSS variables can also be defined directly inside your theme’s theme.json under the settings.custom key.
For example:
{
"settings": {
"custom": {
"carousel-block": {
"navigation-size": "22px",
"navigation-color": "#000",
"pagination-bullet-active-color": "#000"
}
}
}
}
Frontend API
Carousel Slider exposes a small frontend API for integrations with tabs, accordions, modals, or other hidden UI.
window.CarouselSliderBlock.init( container ): Initializes carousel instances inside the given container.window.CarouselSliderBlock.update( container ): Updates existing carousel instances inside the given container and initializes any that are not yet initialized.