This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 56).
ScrollView
一个支持垂直或水平滚动的可滚动容器。
For the complete documentation index, see llms.txt. Use this file to discover all available pages.
一个可滚动的容器，默认进行垂直滚动。对于横向列表，请使用 direction="horizontal"。
安装
- npx expo install @expo/uiIf you are installing this in an existing React Native app, make sure to install expo in your project.
用法
垂直滚动
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}>第 {i + 1} 行</Text> ))} </Column> </ScrollView> </Host> ); }
水平滚动
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}>项目 {i + 1}</Text> ))} </Row> </ScrollView> </Host> ); }
API
import { ScrollView } from '@expo/ui';
Component
Type: React.Element<ScrollViewProps>
A scrollable container that supports vertical or horizontal scrolling.
Props for the ScrollView component.
string • Default: 'vertical'Scroll direction.
Acceptable values are: 'vertical' | 'horizontal'
booleanWhether the component is disabled. Disabled components do not respond to user interaction.
ModifierConfig[]Platform-specific modifier escape hatch. Pass an array of modifier configs
from @expo/ui/swift-ui/modifiers or @expo/ui/jetpack-compose/modifiers.
() => voidCalled when the component is removed from screen.
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.