Holo Carousel & Carousel Item
<holo-carousel> manages a set of <holo-carousel-item> children and exposes a simple slide
selection API, keyboard navigation, and autoplay behavior. Each item is announced by its label
and can be controlled via the parent carousel’s selectedIndex property.
Live Previews
Section titled “Live Previews”Default
Section titled “Default”<holo-carousel label="Featured content"> <holo-carousel-item label="Discovery" active> <div>Discover a better way to work.</div> </holo-carousel-item> <holo-carousel-item label="Build"> <div>Build polished experiences in a shared design system.</div> </holo-carousel-item></holo-carousel>Autoplay
Section titled “Autoplay”<holo-carousel label="Feature highlights" autoplay interval="3200"> <holo-carousel-item label="Plan" active>Plan content</holo-carousel-item> <holo-carousel-item label="Prototype">Prototype content</holo-carousel-item> <holo-carousel-item label="Ship">Ship content</holo-carousel-item></holo-carousel>No indicators
Section titled “No indicators”<holo-carousel label="Suggested reading" show-indicators="false"> <holo-carousel-item label="Design systems" active>Design systems</holo-carousel-item> <holo-carousel-item label="Components">Components</holo-carousel-item></holo-carousel>API Reference
Section titled “API Reference”holo-carousel Properties
Section titled “holo-carousel Properties”| Property | Attribute | Description | Type | Default |
| ---------------- | ----------------- | -------------------------------------------------- | --------- | -------------------- |
| label | label | Accessible label announced by the carousel region. | string | 'Featured content' |
| autoplay | autoplay | Advances automatically on a timed interval. | boolean | false |
| interval | interval | Delay between automatic slide changes in ms. | number | 5000 |
| loop | loop | Whether the carousel wraps around at the ends. | boolean | true |
| showIndicators | show-indicators | Render clickable indicator buttons for each slide. | boolean | true |
| selectedIndex | selected-index | The index of the currently active slide. | number | 0 |
holo-carousel Events
Section titled “holo-carousel Events”| Event | Description | Type |
| -------------------- | -------------------------------------- | ----------------------------------------------- | -------- |
| holoCarouselChange | Emitted when the active slide changes. | CustomEvent<{ index: number; item: HTMLElement | null }> |
holo-carousel Methods
Section titled “holo-carousel Methods”| Method | Description |
| ------------ | ------------------------------------------------------------ |
| next() | Moves to the next slide, wrapping if looping is enabled. |
| previous() | Moves to the previous slide, wrapping if looping is enabled. |
holo-carousel-item Properties
Section titled “holo-carousel-item Properties”| Property | Attribute | Description | Type | Default |
| ---------- | ---------- | ----------------------------------------------------------------------- | --------- | ----------- |
| label | label | Human-readable slide label used in the status region and button labels. | string | undefined |
| active | active | Whether this item is the active slide. | boolean | false |
| disabled | disabled | Optional disabled state. Not required for activation logic. | boolean | false |