跳到主要内容
版本:3.x

ScrollViewContext

增强 ScrollView 实例,可通过 Taro.createSelectorQueryNodesRef.node 方法获取。 仅在 scroll-view 组件开启 enhanced 属性后生效。

支持情况:

参考文档

方法

参数类型说明
scrollEnabledboolean滚动开关
bouncesboolean设置滚动边界弹性 (仅在 iOS 下生效)
showScrollbarboolean设置是否显示滚动条
pagingEnabledboolean分页滑动开关
fastDecelerationboolean设置滚动减速速率
decelerationDisabledboolean取消滚动惯性 (仅在 iOS 下生效)

scrollTo

滚动至指定位置

支持情况:

H5: 不支持 velocity 参数

参考文档

(object: Option) => void
参数类型
objectOption

scrollIntoView

滚动至指定位置

支持情况:

参考文档

(selector: string) => void
参数类型说明
selectorstring元素选择器

参数

scrollTo

Option

参数类型必填说明
topnumber顶部距离
leftnumber左边界距离
velocitynumber初始速度
durationnumber滚动动画时长
animatedboolean是否启用滚动动画

示例代码

Taro.createSelectorQuery()
.select('#scrollview')
.node()
.exec((res) => {
const scrollView = res[0].node;
scrollView.scrollEnabled = false;
})

API 支持度

API微信小程序抖音小程序H5React NativeHarmony
ScrollViewContext✔️
ScrollViewContext.scrollTo✔️✔️(不支持 velocity 参数)
ScrollViewContext.scrollIntoView✔️✔️✔️