#scroll-view
可滚动容器,支持垂直和水平方向内容滚动,适用于内容超出可视区域的场景。
#扫码预览
#Props
| 属性名 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| bounces | boolean | true | 否 | 是否启用弹性效果(iOS 回弹效果) |
| children | ReactNode | - | 否 | 子元素 |
| className | string | - | 否 | 组件类名 |
| enableScroll | boolean | true | 否 | 是否允许滚动 |
| id | string | - | 否 | 元素的唯一标识 |
| initialScrollOffset | number | 0 | 否 | 初始滚动偏移量(px),仅首屏有效 |
| initialScrollToIndex | number | 0 | 否 | 初始滚动到指定子节点的索引,仅首屏有效。所有直接子节点必须设置 flatten=false |
| key | string | number | null | - | 否 | React key 属性 |
| lowerThreshold | number | 0 | 否 | 触发滚动到底部/右侧的距离阈值(px) |
| onContentSizeChanged | (event: ContentSizeChangedEvent) => void | - | 否 | 内容尺寸变化时触发 |
| onScroll | (event: ScrollEvent) => void | - | 否 | 滚动过程中触发 |
| onScrollEnd | (event: ScrollEndEvent) => void | - | 否 | 滚动结束时触发 |
| onScrollToLower | (event: ScrollToLowerEvent) => void | - | 否 | 滚动到底部/右侧时触发 |
| onScrollToUpper | (event: ScrollToUpperEvent) => void | - | 否 | 滚动到顶部/左侧时触发 |
| ref | Ref<NodesRef> | - | 否 | 用于获取组件实例的 ref |
| scrollBarEnable | boolean | true | 否 | 是否显示滚动条 |
| scrollOrientation | "horizontal" | "vertical" | 'vertical' | 否 | 滚动方向 |
| style | CSSProperties | - | 否 | 组件样式 |
| upperThreshold | number | 0 | 否 | 触发滚动到顶部/左侧的距离阈值(px) |