SelectorQuery

查询节点信息的对象

方法

in

将选择器的选取范围更改为自定义组件 component 内。（初始时，选择器仅选取页面范围的节点，不会选取任何自定义组件中的节点）。

Component({
  queryMultipleNodes() {
    const query = Taro.createSelectorQuery().in(this);
    query
      .select("#the-id")
      .boundingClientRect(function (res) {
        res.top; // 这个组件内 #the-id 节点的上边界坐标
      })
      .exec();
  },
});

select

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

Taro.createSelectorQuery()
  .select("#the-id")
  .fields(
    {
      dataset: true,
      size: true,
      scrollOffset: true,
      properties: ["scrollX", "scrollY"],
    },
    function (res) {
      res.dataset; // 节点的dataset
      res.width; // 节点的宽度
      res.height; // 节点的高度
      res.scrollLeft; // 节点的水平滚动位置
      res.scrollTop; // 节点的竖直滚动位置
      res.scrollX; // 节点 scroll-x 属性的当前值
      res.scrollY; // 节点 scroll-x 属性的当前值
    }
  )
  .exec();