For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt, and this page is available as Markdown at /apps-plugin/docs/components/view-container/scroll-view.md.

scroll-view

可滚动容器,支持垂直和水平方向内容滚动,适用于内容超出可视区域的场景。

扫码预览

扫码预览 scroll-view

Props

属性名类型默认值必填说明
bouncesbooleantrue否是否启用弹性效果(iOS 回弹效果)
childrenReactNode-否子元素
classNamestring-否组件类名
enableScrollbooleantrue否是否允许滚动
idstring-否元素的唯一标识
initialScrollOffsetnumber0否初始滚动偏移量(px),仅首屏有效
initialScrollToIndexnumber0否初始滚动到指定子节点的索引,仅首屏有效。所有直接子节点必须设置 flatten=false
keystring | number | null-否React key 属性
lowerThresholdnumber0否触发滚动到底部/右侧的距离阈值(px)
onContentSizeChanged(event: ContentSizeChangedEvent) => void-否内容尺寸变化时触发
onScroll(event: ScrollEvent) => void-否滚动过程中触发
onScrollEnd(event: ScrollEndEvent) => void-否滚动结束时触发
onScrollToLower(event: ScrollToLowerEvent) => void-否滚动到底部/右侧时触发
onScrollToUpper(event: ScrollToUpperEvent) => void-否滚动到顶部/左侧时触发
refRef<NodesRef>-否用于获取组件实例的 ref
scrollBarEnablebooleantrue否是否显示滚动条
scrollOrientation"horizontal" | "vertical"'vertical'否滚动方向
styleCSSProperties-否组件样式
upperThresholdnumber0否触发滚动到顶部/左侧的距离阈值(px)