Reference version

ScrollView

A scrollable container that supports vertical or horizontal scrolling.

Android
iOS
Web
Included in Expo Go
Bundled version:
~56.0.2

For the complete documentation index, see llms.txt. Use this file to discover all available pages.

A scrollable container, defaulting to vertical scrolling. Use direction="horizontal" for horizontal lists.

Installation

Terminal
npx expo install @expo/ui

If you are installing this in an existing React Native app, make sure to install expo in your project.

Usage

Vertical scrolling

VerticalScrollViewExample.tsx
import { Host, ScrollView, Column, Text } from '@expo/ui'; export default function VerticalScrollViewExample() { return ( <Host style={{ flex: 1 }}> <ScrollView> <Column spacing={8}> {Array.from({ length: 30 }).map((_, i) => ( <Text key={i}>Row {i + 1}</Text> ))} </Column> </ScrollView> </Host> ); }

Horizontal scrolling

HorizontalScrollViewExample.tsx
import { Host, ScrollView, Row, Text } from '@expo/ui'; export default function HorizontalScrollViewExample() { return ( <Host style={{ flex: 1 }}> <ScrollView direction="horizontal"> <Row spacing={12}> {Array.from({ length: 20 }).map((_, i) => ( <Text key={i}>Item {i + 1}</Text> ))} </Row> </ScrollView> </Host> ); }

API

import { ScrollView } from '@expo/ui';

Component

ScrollView

Android
iOS
Web

Type: React.Element<ScrollViewProps>

A scrollable container that supports vertical or horizontal scrolling.

Props for the ScrollView component.

ScrollViewProps

children

Android
iOS
Web
Optional • Type: ReactNode

Content to render inside the scroll view.

direction

Android
iOS
Web
Optional • Literal type: string • Default: 'vertical'

Scroll direction.

Acceptable values are: 'horizontal' | 'vertical'

disabled

Android
iOS
Web
Optional • Type: boolean

Whether the component is disabled. Disabled components do not respond to user interaction.

hidden

Android
iOS
Web
Optional • Type: boolean

Whether the component is hidden.

modifiers

Android
iOS
Optional • Type: ModifierConfig[]

Platform-specific modifier escape hatch. Pass an array of modifier configs from @expo/ui/swift-ui/modifiers or @expo/ui/jetpack-compose/modifiers.

onAppear

Android
iOS
Web
Optional • Type: () => void

Called when the component appears on screen.

onDisappear

Android
iOS
Web
Optional • Type: () => void

Called when the component is removed from screen.

onPress

Android
iOS
Web
Optional • Type: () => void

Called when the component is pressed.

showsIndicators

iOS
Web
Optional • Type: boolean • Default: true

Whether to show scroll indicators.

style

Android
iOS
Web
Optional • Type: Pick<ViewStyle, 'padding' | 'paddingHorizontal' | 'paddingVertical' | 'paddingTop' | 'paddingBottom' | 'paddingLeft' | 'paddingRight' | 'backgroundColor' | 'borderRadius' | 'borderWidth' | 'borderColor' | 'opacity' | 'width' | 'height'>

Platform-agnostic style properties. These are translated to SwiftUI modifiers on iOS and Jetpack Compose modifiers on Android.

testID

Android
iOS
Web
Optional • Type: string

Identifier used to locate the component in end-to-end tests.