开发
API

SelectorQuery.select

在当前页面或自定义组件中选择第一个匹配选择器的节点,返回一个 NodesRef 对象实例,可以用于获取节点信息。

语法

selectorQuery.select(selector)

参数说明

string selector

选择器字符串。

选择器字符串类似于在 CSS 中使用的选择器,但仅支持下列语法

  • ID 选择器:#the-id
  • class 选择器(可以连续指定多个):.a-class.another-class
  • 子元素选择器:.the-parent > .the-child
  • 后代选择器:.the-ancestor .the-descendant
  • 跨自定义组件的后代选择器:.the-ancestor >>> .the-descendant
  • 多选择器的并集:#a-node, .some-other-nodes

返回值

NodesRef

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

TTML

<button id="btn">示例按钮</button>

JavaScript

const query = tt.createSelectorQuery();

// 选择 ttml 中的示例按钮,并添加一个对它布局信息的查询
query.select("#btn").boundingClientRect();

// 执行查询
query.exec(function (res) {
  console.log(res[0].width, res[0].height);
});
点击纠错
评价此篇文档