小程序 API 能力汇总——TYML SelectorQuery API

SelectorQuery

查询节点信息的对象

方法

NodesRef SelectorQuery.select(string selector)

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

NodesRef SelectorQuery.selectAll(string selector)

在当前页面下选择匹配选择器 selector 的所有节点。

NodesRef SelectorQuery.selectViewport()

选择显示区域。可用于获取显示区域的尺寸、滚动位置等信息。

NodesRef SelectorQuery.exec(function callback)

执行所有的请求。请求结果按请求次序构成数组，在 callback 的第一个参数中返回。

ty.createSelectorQuery()

返回一个 SelectorQuery 对象实例。在自定义组件中，应使用 this.createSelectorQuery() 来代替。

返回值

SelectorQuery

方法

 同 SelectorQuery。

示例代码

const query = ty.createSelectorQuery();
query.select('#the-id').boundingClientRect();
query.selectViewport().scrollOffset();
query.exec(function (res) {
  res[0].top; // #the-id节点的上边界坐标
  res[1].scrollTop; // 显示区域的竖直滚动位置
});

SelectorQuery.select(string selector)

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

参数

string selector

选择器

返回值

NodesRef

selector 语法

selector 类似于 CSS 的选择器，但仅支持下列语法。

• ID 选择器：#the-id
• class 选择器：.a-class

SelectorQuery.selectAll(string selector)

在当前页面下选择匹配选择器 selector 的所有节点。

参数

string selector

选择器

返回值

NodesRef

selector 语法

selector 类似于 CSS 的选择器，但仅支持下列语法。

• ID 选择器：#the-id
• class 选择器：.a-class

SelectorQuery.exec(function callback)

执行所有的请求。请求结果按请求次序构成数组，在 callback 的第一个参数中返回。

参数

function callback

回调函数

返回值

NodesRef

SelectorQuery.selectViewport()

选择显示区域。可用于获取显示区域的尺寸、滚动位置等信息

返回值

NodesRef

👉 立即开发。