---
name: "NodesRef.scrollOffset"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.10.0" }
title: "NodesRef.scrollOffset - 添加节点的滚动位置查询请求"
---

## NodesRef.scrollOffset

> [VERSION] 基础库 >= 2.10.0

### 描述

添加节点的滚动位置查询请求。以像素为单位。节点必须是 scroll-view 或者 viewport

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `e` | `any` | 是 | 回调函数，参数为节点的滚动信息（id, dataset, scrollLeft, scrollTop） |

### 返回值

类型: `SelectorQuery`

SelectorQuery 对象

### 示例代码

#### 获取滚动位置

```html
// index.tyml
<scroll-view scroll-y="{{true}}" id="scroller" class="scroll">
  <view ty:for="{{list}}" ty:key="*this" class="row">{{item}}</view>
</scroll-view>
<button bind:tap="getScrollOffset">获取滚动位置</button>
```

```js
// index.js
Page({
  data: {
    list: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
  },
  getScrollOffset() {
    ty.createSelectorQuery()
      .selectViewport()
      .scrollOffset((res) => {
        console.log('滚动位置', res.scrollTop, res.scrollLeft);
      })
      .exec();
  },
});
```

```css
// index.tyss
.scroll {
  height: 400rpx;
}
.row {
  height: 80rpx;
  line-height: 80rpx;
  border-bottom: 1rpx solid #eee;
  padding-left: 20rpx;
}
```