php artisan aura:add carousel
Copies the component source into resources/views/components/aura/. Run php artisan aura:init first if you haven't already. See the CLI guide for all options.
composer require bluestarsystem/aura-ui
php artisan aura:install
Full installation instructions in the Installation guide.
Pro Component — This component requires an Aura UI Pro license.
Basic Usage
<x-aura::carousel>
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-gradient-to-r from-violet-500 to-indigo-500 rounded-lg">
<p class="text-white text-xl font-bold">Slide 1</p>
</div>
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-gradient-to-r from-cyan-500 to-blue-500 rounded-lg">
<p class="text-white text-xl font-bold">Slide 2</p>
</div>
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-gradient-to-r from-emerald-500 to-teal-500 rounded-lg">
<p class="text-white text-xl font-bold">Slide 3</p>
</div>
</x-aura::carousel.slide>
</x-aura::carousel><x-aura::carousel>
<x-aura::carousel.slide>
<img src="/images/slide-1.jpg" alt="Slide 1" class="w-full rounded-lg" />
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<img src="/images/slide-2.jpg" alt="Slide 2" class="w-full rounded-lg" />
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<img src="/images/slide-3.jpg" alt="Slide 3" class="w-full rounded-lg" />
</x-aura::carousel.slide>
</x-aura::carousel>
Props
| Prop | Type | Default | Description |
|---|---|---|---|
autoplay |
bool |
false |
Automatically advance slides at the given interval. |
interval |
int |
5000 |
Time in milliseconds between automatic slide transitions. |
loop |
bool |
true |
Whether the carousel wraps around from the last slide back to the first. |
indicators |
bool |
true |
Show dot indicators below the slides. |
arrows |
bool |
true |
Show previous/next navigation arrows. |
slidesPerView |
int |
1 |
Number of slides visible at the same time. |
Examples
Autoplay Carousel
<x-aura::carousel :autoplay="true" :interval="3000" :loop="true">
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-gradient-to-r from-amber-500 to-orange-500 rounded-lg">
<p class="text-white text-xl font-bold">Promo 1</p>
</div>
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-gradient-to-r from-rose-500 to-pink-500 rounded-lg">
<p class="text-white text-xl font-bold">Promo 2</p>
</div>
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-gradient-to-r from-fuchsia-500 to-purple-500 rounded-lg">
<p class="text-white text-xl font-bold">Promo 3</p>
</div>
</x-aura::carousel.slide>
</x-aura::carousel><x-aura::carousel :autoplay="true" :interval="3000" :loop="true">
<x-aura::carousel.slide>
<img src="/images/promo-1.jpg" alt="Promo 1" class="w-full rounded-lg" />
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<img src="/images/promo-2.jpg" alt="Promo 2" class="w-full rounded-lg" />
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<img src="/images/promo-3.jpg" alt="Promo 3" class="w-full rounded-lg" />
</x-aura::carousel.slide>
</x-aura::carousel>
No Arrows (Indicators Only)
<x-aura::carousel :arrows="false">
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-violet-100 rounded-lg">
<p class="text-violet-700 text-lg font-semibold">Slide One</p>
</div>
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-indigo-100 rounded-lg">
<p class="text-indigo-700 text-lg font-semibold">Slide Two</p>
</div>
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-sky-100 rounded-lg">
<p class="text-sky-700 text-lg font-semibold">Slide Three</p>
</div>
</x-aura::carousel.slide>
</x-aura::carousel><x-aura::carousel :arrows="false">
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-violet-100 rounded-lg">
<p class="text-violet-700 text-lg font-semibold">Slide One</p>
</div>
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-indigo-100 rounded-lg">
<p class="text-indigo-700 text-lg font-semibold">Slide Two</p>
</div>
</x-aura::carousel.slide>
<x-aura::carousel.slide>
<div class="flex items-center justify-center h-48 bg-sky-100 rounded-lg">
<p class="text-sky-700 text-lg font-semibold">Slide Three</p>
</div>
</x-aura::carousel.slide>
</x-aura::carousel>
Accessibility
- The carousel uses
role="region"witharia-roledescription="carousel"for proper semantics. - Each slide has
role="tabpanel"and is labeled witharia-label="Slide N of M". - Navigation arrows include
aria-label="Previous slide"andaria-label="Next slide". - Indicators use
role="tablist"with individualrole="tab"buttons. - Autoplay pauses automatically when the carousel receives focus or hover.
- Keyboard navigation: Arrow Left/Right to change slides, Space/Enter to activate indicators.