---
name: "SelectorQuery"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.10.0" }
title: "SelectorQuery - 查询节点信息的对象"
---

## SelectorQuery

> [VERSION] 基础库 >= 2.10.0

### 描述

查询节点信息的对象。通过 [ty.createSelectorQuery()](/cn/miniapp/develop/miniapp/api/tyml/SelectorQuery/createSelectorQuery) 创建实例，用于在页面或自定义组件中查询节点布局信息、滚动位置等。

### 参数

无


### 返回值

类型: `SelectorQuery`

SelectorQuery 实例

#### 方法

| 方法名 | 说明 |
| --- | --- |
| `select` | 在当前页面下选择第一个匹配选择器 selector 的节点。返回一个 NodesRef 对象实例，可以用于获取节点信息 |
| `selectAll` | 在当前页面下选择匹配选择器的所有节点，返回 NodesRef 对象实例 |
| `selectViewport` | 选择显示区域，可用于获取显示区域的尺寸、滚动位置等信息 |
| `exec` | 执行所有的请求。请求结果按请求次序构成数组，在 callback 的第一个参数中返回 |

### 示例代码

#### 创建 SelectorQuery 查询节点

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