Svelte Carousel - Flowbite
Use the carousel component to slide through multiple elements and images using custom controls, indicators, intervals, and options
The carousel component can be used to cycle through a set of elements using custom options, controls, and indicators.
Setup #
- Svelte
<script lang="ts">
import { Carousel } from "flowbite-svelte";
// ./imageData/+server.js has the following
export const images = [
{
alt: "Cosmic timetraveler",
src: "/images/carousel/cosmic-timetraveler-pYyOZ8q7AII-unsplash.webp",
title: "cosmic-timetraveler-pYyOZ8q7AII-unsplash.com"
},
{
alt: "Cristina Gottardi",
src: "/images/carousel/cristina-gottardi-CSpjU6hYo_0-unsplash.webp",
title: "cristina-gottardi-CSpjU6hYo_0-unsplash.com"
},
{
alt: "Johannes Plenio",
src: "/images/carousel/johannes-plenio-RwHv7LgeC7s-unsplash.webp",
title: "johannes-plenio-RwHv7LgeC7s-unsplash.com"
},
{
alt: "Jonatan Pie",
src: "/images/carousel/jonatan-pie-3l3RwQdHRHg-unsplash.webp",
title: "jonatan-pie-3l3RwQdHRHg-unsplash.com"
},
{
alt: "Mark Harpur",
src: "/images/carousel/mark-harpur-K2s_YE031CA-unsplash.webp",
title: "mark-harpur-K2s_YE031CA-unsplash"
},
{
alt: "Pietro De Grandi",
src: "/images/carousel/pietro-de-grandi-T7K4aEPoGGk-unsplash.webp",
title: "pietro-de-grandi-T7K4aEPoGGk-unsplash"
},
{
alt: "Sergey Pesterev",
src: "/images/carousel/sergey-pesterev-tMvuB9se2uQ-unsplash.webp",
title: "sergey-pesterev-tMvuB9se2uQ-unsplash"
},
{
alt: "Solo travel goals",
src: "/images/carousel/solotravelgoals-7kLufxYoqWk-unsplash.webp",
title: "solotravelgoals-7kLufxYoqWk-unsplash"
}
];
</script>
Default Carousel #
Set the duration
prop (in milliseconds) to define the auto‑advance interval between slides.
The default value of duration
is 0
(no auto‑advance). In that case, control the visible slide with the index
prop.
- Svelte
<script lang="ts">
import { Carousel } from "flowbite-svelte";
import images from "./imageData/images.json";
</script>
<Carousel {images} duration={3000} />
Controls #
Use the internal Controls
component to listen to click events which will trigger the slide event from the carousel component to each direction.
You can customize the control elements with the class
property.
- Svelte
<script lang="ts">
import { Carousel, Controls } from "flowbite-svelte";
import images from "./imageData/images.json";
</script>
<div class="max-w-4xl">
<Carousel {images}>
<Controls />
</Carousel>
</div>
Indicators #
Show the carousel indicators by adding the internal Indicators
component.
- Svelte
<script lang="ts">
import { Carousel, CarouselIndicators } from "flowbite-svelte";
import images from "./imageData/images.json";
</script>
<div class="max-w-4xl">
<Carousel {images}>
<CarouselIndicators />
</Carousel>
</div>
Thumbnails #
You can control the Carousel
component externally by the index
prop. Here is an example how to use the Thumbnails
component to achieve that.
- Svelte
<script lang="ts">
import { Carousel, Controls, CarouselIndicators, Thumbnails } from "flowbite-svelte";
import images from "./imageData/images.json";
let index = $state(0);
</script>
<div class="max-w-4xl space-y-4">
<Carousel {images} bind:index>
<Controls />
<CarouselIndicators />
</Carousel>
<Thumbnails {images} bind:index />
</div>
Caption #
The Carousel
exposes the change
event containing info about the currently displayed image. You can use it to build custom caption for the carousel.
- Svelte
<script lang="ts">
import { Carousel, Controls, CarouselIndicators } from "flowbite-svelte";
import images from "./imageData/images.json";
import type { HTMLImgAttributes } from "svelte/elements";
let index = $state(0);
let image: HTMLImgAttributes | undefined = $state();
</script>
<div class="max-w-4xl space-y-4">
<Carousel {images} onchange={(detail) => (image = detail)}>
<Controls />
<CarouselIndicators />
</Carousel>
<div class="my-2 h-10 rounded-sm bg-gray-300 p-2 text-center dark:bg-gray-700 dark:text-white">
{image?.alt}
</div>
</div>
Carousel with links #
You can use slide
snippet and internal component Slide
to control the image display. Here’s an example how to wrap images with the anchor element.
- Svelte
<script lang="ts">
import { Carousel } from "flowbite-svelte";
import images from "./imageData/images.json";
</script>
<div class="max-w-4xl space-y-4">
<Carousel {images} duration={3900}>
{#snippet slide({ index, Slide })}
<a href="http://google.com/search?q={images[index]?.title}" target="_blank">
<Slide image={images[index]} />
</a>
{/snippet}
<!-- Indicators / -->
</Carousel>
</div>
A11y #
Use Tab
and Shift+Tab
to navigate between Controls
, Indicators
, and Thumbnails
.
Customization #
Basic customization #
- Svelte
<script lang="ts">
import { Carousel } from "flowbite-svelte";
import images from "./imageData/images.json";
</script>
<div class="max-w-4xl space-y-4">
<Carousel {images} duration={3900}>
{#snippet slide({ index, Slide })}
<a href="http://google.com/search?q={images[index]?.title}" target="_blank">
<Slide image={images[index]} />
</a>
{/snippet}
<!-- Indicators / -->
</Carousel>
</div>
Advanced customization #
- Svelte
<script lang="ts">
import { Button, Carousel, ControlButton, Controls, Indicator, CarouselIndicators, Thumbnails } from "flowbite-svelte";
import { CaretRightOutline } from "flowbite-svelte-icons";
import images from "./imageData/images.json";
let index = $state(0);
</script>
<div class="max-w-4xl space-y-4">
<Carousel {images} bind:index>
<CarouselIndicators>
{#snippet children({ selected, index })}
<Indicator color={selected ? "red" : "green"} class="h-5 w-5 border border-white text-white {selected ? 'opacity-100' : 'opacity-80'}">
{index}
</Indicator>
{/snippet}
</CarouselIndicators>
<Controls>
{#snippet children(changeSlide)}
<ControlButton name="Previous" forward={false} onclick={() => changeSlide(false)} />
<Button pill class="absolute end-4 top-1/2 -translate-y-1/2 p-2 font-bold" onclick={() => changeSlide(true)}>
<CaretRightOutline />
</Button>
{/snippet}
</Controls>
</Carousel>
<Thumbnails class="mt-4 gap-3 bg-transparent" {images} bind:index>
{#snippet children({ image, selected, Thumbnail })}
<Thumbnail {selected} {...image} class="hover:outline-primary-500 rounded-md shadow-xl hover:outline {selected ? 'outline-primary-400 outline-4' : ''}" />
{/snippet}
</Thumbnails>
</div>
Custom Carousel transition #
- Svelte
<script lang="ts">
import { Carousel, Controls, CarouselIndicators } from "flowbite-svelte";
import images from "./imageData/images.json";
import { scale } from "svelte/transition";
import { quintOut } from "svelte/easing";
const scaleAnimation = (node: HTMLElement) => scale(node, { duration: 500, easing: quintOut });
</script>
<div class="max-w-4xl">
<Carousel {images} transition={scaleAnimation}>
<Controls />
<CarouselIndicators />
</Carousel>
</div>
Component data #
The component has the following props, type, and default values. See types page for type information.