Skip to main content
196

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
React Native docs
Data displayReact Native

Carousel

Page through controlled native slides with accessible navigation.

Public APILumenCarouselReact Native

Native example

Use Carousel

Hosts own stable slide identities and rich content. Native paging requests bounded index changes; there is no autoplay or wrapping. Invalid host indices show recovery without rewriting state.

View captured React Native example
Carousel rendered in the Expo web renderer Lumen playground
Captured exampleExpo web renderer
tsx
<LumenCarousel label="Project slides" slides={slides} index={index} onIndexChange={setIndex} renderSlide={slide => <LumenText>{slide.label}</LumenText>} />

Reference

Public API

The primary shared and platform-specific options exposed by LumenCarousel.

APIValues or typeDefaultDescription
slides / indexStable LumenCarouselSlide records / controlled integerRequiredControls the dataset and current visible page.
height / disabled / statusNumeric height / boolean / ready-loading-error200 / false / readyBounds the viewport and guards native paging and result states.

Native behavior

Design and accessibility

When to use it

Hosts own stable slide identities and rich content. Native paging requests bounded index changes; there is no autoplay or wrapping. Invalid host indices show recovery without rewriting state.

Accessibility

Localized slide positions, named previous/next and selected indicators with native paging.

Shared component

Available on other platforms

Apple / SwiftUIAndroid / Compose
React Native docsNative primitives