---
name: "NodesRef.fields"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.10.0" }
title: "NodesRef.fields - 获取节点的相关信息"
---

## NodesRef.fields

> [VERSION] 基础库 >= 2.10.0

### 描述

获取节点的相关信息。需要获取的字段在 fields 中指定

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `e` | `any` | 是 | 指定获取的字段（id, dataset, rect, size, scrollOffset, properties 等） |
| `t` | `any` | 是 | 回调函数，参数为节点信息 |

### 返回值

类型: `SelectorQuery`

SelectorQuery 对象

### 示例代码

#### 获取节点自定义字段

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

```js
// index.js
Page({
  onReady() {
    ty.createSelectorQuery()
      .select('#box')
      .fields({
        id: true,
        dataset: true,
        rect: true,
        size: true,
        scrollOffset: true,
        properties: ['style'],
      }, (res) => {
        console.log('节点信息', res);
      })
      .exec();
  },
});
```

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