---
name: "SelectorQuery.select"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.10.0" }
title: "SelectorQuery.select - 选择第一个匹配的节点"
---

## SelectorQuery.select

> [VERSION] 基础库 >= 2.10.0

### 描述

在当前页面下选择第一个匹配选择器 selector 的节点。返回一个 NodesRef 对象实例，可以用于获取节点信息

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `selector` | `string` | 是 | 选择器，支持 id 选择器（#id）和 class 选择器（.class） |

### 返回值

类型: `NodesRef`

[NodesRef 对象](/cn/miniapp/develop/miniapp/api/tyml/NodesRef/NodesRef)

### 示例代码

#### 选择单个节点

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

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

```css
// index.tyss
.box {
  width: 200rpx;
  height: 100rpx;
  background-color: #f0f0f0;
}
```