ScrollViewContext.scrollTo(Object object)

基础库 2.14.4 开始支持,低版本需做兼容处理。

微信小程序插件:支持

微信 Windows 版:支持

微信 Mac 版:支持

功能描述

滚动至指定位置

参数

Object object

属性 类型 默认值 必填 说明
top number 顶部距离
left number 左边界距离
velocity number 初始速度 (webview 仅在 iOS 下生效;skyline 在 3.14.3 后支持)
duration number 滚动动画时长 (webview 仅在 iOS 下生效;skyline 在 3.14.3 后支持)
animated boolean 是否启用滚动动画

ScrollViewContext.scrollIntoView(string selector, object ScrollIntoViewOptions)

基础库 2.14.4 开始支持,低版本需做兼容处理。

微信小程序插件:支持

微信 Windows 版:支持

微信 Mac 版:支持

功能描述

滚动至指定位置

参数

string selector

元素选择器

object ScrollIntoViewOptions

基础库 3.1.0 开始支持,低版本需做兼容处理。

配置项,仅 Skyine 模式支持

属性 类型 默认值 必填 说明
offset number 0 跳转到目标节点时的额外偏移
withinExtent boolean false 只跳转到 cacheExtent 以内的目标节点,性能更佳
alignment string “start” 指定目标节点在视口内的位置
animated boolean true 是否启用滚动动画

ScrollViewContext

基础库 2.14.4 开始支持,低版本需做兼容处理。

增强微信小程序中的 ScrollView 实例,可通过 wx.createSelectorQuery 的 NodesRef.node 方法获取。 仅在 scroll-view 组件开启 enhanced 属性后生效。

属性

boolean scrollEnabled

滚动开关

boolean bounces

设置滚动边界弹性 (仅在 iOS 下生效)

boolean showScrollbar

设置是否显示滚动条

boolean pagingEnabled

分页滑动开关

boolean fastDeceleration

设置滚动减速速率 (仅在 iOS 下生效)

boolean decelerationDisabled

取消滚动惯性 (仅在 iOS 下生效)

方法

ScrollViewContext.triggerRefresh(Object object)

触发下拉刷新。

ScrollViewContext.closeRefresh()

关闭下拉刷新。

ScrollViewContext.triggerTwoLevel(Object object)

触发下拉二级。

ScrollViewContext.closeTwoLevel(Object object)

关闭下拉二级。

ScrollViewContext.scrollTo(Object object)

滚动至指定位置

ScrollViewContext.scrollIntoView(string selector, object ScrollIntoViewOptions)

滚动至指定位置

示例代码

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