开发
API

SelectorQuery.selectAll

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

语法

selectorQuery.selectAll(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="btn1" class="btn">示例按钮1</button> <button id="btn2" class="btn">示例按钮2</button>

JavaScript

const query = tt.createSelectorQuery();

// 选择所有类名为 btn 的节点,并添加一个对它们布局信息的查询
query.selectAll(".btn").boundingClientRect();

// 执行查询
query.exec(function (res) {
  // 对应 #btn1 的布局信息
  console.log(res[0][0]);

  // 对应 #btn2 的布局信息
  console.log(res[0][1]);
});
点击纠错
评价此篇文档