title: nodesRef.scrollOffset([callback])

sidebar_label: nodesRef.scrollOffset

添加节点的滚动位置查询请求,以像素为单位。节点必须是 scroll-view 或者 viewport。返回值是 nodesRef 对应的 selectorQuery。

返回的节点信息中,每个节点的滚动位置用 scrollLeft、scrollTop 字段描述。如果提供了 callback 回调函数,在执行 selectQuery 的 exec 方法后,节点信息会在 callback 中返回。

示例代码

  1. import Taro from '@tarojs/taro'
  2. Taro.createSelectorQuery()
  3. .selectViewport()
  4. .scrollOffset(rect => {
  5. rect.id // 节点的 ID
  6. rect.dataset // 节点的 dataset
  7. res.scrollLeft // 节点的水平滚动位置
  8. res.scrollTop // 节点的竖直滚动位置
  9. })
  10. .exec()
  11. })

API支持度

API 微信小程序 H5 React Native
selectorQuery.in ✔️ ✔️
selectorQuery.select ✔️ ✔️
selectorQuery.selectAll ✔️ ✔️
selectorQuery.selectViewport ✔️ ✔️
nodesRef.boundingClientRect ✔️ ✔️
nodesRef.scrollOffset ✔️ ✔️
nodesRef.fields ✔️ ✔️
selectorQuery.exec ✔️ ✔️