---
name: "NodesRef"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.10.0" }
title: "NodesRef - 用于获取 TYML 节点信息的对象"
---

## NodesRef

> [VERSION] 基础库 >= 2.10.0

### 描述

用于获取 TYML 节点信息的对象。通过 [SelectorQuery.select()](/cn/miniapp/develop/miniapp/api/tyml/SelectorQuery/select) 等方法获取 NodesRef 实例，可用于查询节点布局位置、滚动偏移量等信息。

### 参数

无


### 返回值

类型: `NodesRef`

NodesRef 实例

#### 方法

| 方法名 | 说明 |
| --- | --- |
| `fields` | 获取节点的相关信息。需要获取的字段在 fields 中指定 |
| `boundingClientRect` | 添加节点的布局位置的查询请求。相对于显示区域，以像素为单位。其功能类似于 DOM 的 getBoundingClientRect |
| `scrollOffset` | 添加节点的滚动位置查询请求。以像素为单位。节点必须是 scroll-view 或者 viewport |

### 示例代码

#### 获取节点布局信息

```html
// index.tyml
<view id="box" class="box">目标节点</view>
```

```js
// index.js
Page({
  onReady() {
    ty.createSelectorQuery()
      .select('#box')
      .boundingClientRect((rect) => {
        console.log('节点信息', rect);
      })
      .exec();
  },
});
```

```css
// index.tyss
.box {
  width: 300rpx;
  height: 150rpx;
  background-color: #e8f4ff;
}
```