scroll-view
更新时间：2025-12-09 14:57:44
scroll-view
scroll-view组件
属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| style | string | 类型 | ||
| scroll-x | boolean | false | 是否允许横向滚动 | |
| scroll-y | boolean | false | 是否允许纵向滚动 | |
| upper-threshold | number,string | 50 | 距顶部/左边多远时，触发 scrolltoupper 事件 | |
| lower-threshold | number,string | 50 | 距底部/右边多远时，触发 scrolltolower 事件 | |
| scroll-top | number,string | 设置竖向滚动条位置 | ||
| scroll-left | number,string | 设置横向滚动条位置 | ||
| scroll-into-view | string | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素 | ||
| scroll-with-animation | boolean | false | 在设置滚动条位置时使用动画过渡 | |
| enable-flex | boolean | false | 启用 flexbox 布局。开启后，当前节点声明了 display: flex 就会成为 flex container，并作用于其孩子节点，display-direction 默认是 row，需要开发者在 scroll-view 上设置 flex-direction 为 column | |
| refresher-enabled | boolean | false | 开启自定义下拉刷新 | |
| refresher-threshold | number | 45 | 设置自定义下拉刷新阈值 | |
| refresher-default-style | string | black | 设置自定义下拉刷新默认样式，支持设置 black | |
| refresher-background | string | #FFF | 设置自定义下拉刷新区域背景颜色 | |
| refresher-triggered | boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发，开发者需要先将 refresherTriggered 手动置为 true，再置为 false，来触发 refresherrestore 事件，以及隐藏 refresher | |
| show-scrollbar | boolean | true | 滚动条显隐控制 (同时开启 enhanced 属性后生效) | |
| bindscrolltoupper | eventhandle | 滚动到顶部/左边时触发 | ||
| bindscrolltolower | eventhandle | 滚动到底部/右边时触发 | ||
| bindscroll | eventhandle | 滚动时触发 | ||
| bindrefresherpulling | eventhandle | 自定义下拉刷新控件被下拉 | ||
| bindrefresherrefresh | eventhandle | 自定义下拉刷新被触发 | ||
| bindrefresherrestore | eventhandle | 自定义下拉刷新被复位 |
扫码预览
组件示例
该文档是否对您有帮助？