微信小程序API WXML节点信息

wx.createSelectorQuery()

---

基础库 1.4.0 开始支持，低版本需做兼容处理

返回一个SelectorQuery对象实例。可以在这个实例上使用select等方法选择节点，并使用boundingClientRect等方法选择需要查询的信息。

示例代码：

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

selectorQuery

selectorQuery 对象的方法列表：

selectorQuery.select(selector)

---

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

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

• ID选择器：#the-id
• class选择器（可以连续指定多个）：.a-class.another-class
• 子元素选择器：.the-parent > #the-child.a-class
• 多选择器的并集：#a-node, .some-other-nodes

selectorQuery.selectAll(selector)

---

在当前页面下选择匹配选择器selector的节点，返回一个NodesRef对象实例。 与selectorQuery.selectNode(selector)不同的是，它选择所有匹配选择器的节点。

selectorQuery.selectViewport()

---

选择显示区域，可用于获取显示区域的尺寸、滚动位置等信息，返回一个NodesRef对象实例。

nodesRef.boundingClientRect([callback])

---

添加节点的布局位置的查询请求，相对于显示区域，以像素为单位。其功能类似于DOM的getBoundingClientRect。返回值是nodesRef对应的selectorQuery。

返回的节点信息中，每个节点的位置用left、right、top、bottom、width、height字段描述。如果提供了callback回调函数，在执行selectQuery的exec方法后，节点信息会在callback中返回。

示例代码：

Page({  getRect: function(){    wx.createSelectorQuery().select('#the-id').boundingClientRect(function(rect){      rect.id      // 节点的ID      rect.dataset // 节点的dataset      rect.left    // 节点的左边界坐标      rect.right   // 节点的右边界坐标      rect.top     // 节点的上边界坐标      rect.bottom  // 节点的下边界坐标      rect.width   // 节点的宽度      rect.height  // 节点的高度    }).exec()  },  getAllRects: function(){    wx.createSelectorQuery().selectAll('.a-class').boundingClientRect(function(rects){      rects.forEach(function(rect){        rect.id      // 节点的ID        rect.dataset // 节点的dataset        rect.left    // 节点的左边界坐标        rect.right   // 节点的右边界坐标        rect.top     // 节点的上边界坐标        rect.bottom  // 节点的下边界坐标        rect.width   // 节点的宽度        rect.height  // 节点的高度      })    }).exec()  }})

nodesRef.scrollOffset([callback])

---

添加节点的滚动位置查询请求，以像素为单位。节点必须是scroll-view或者viewport。返回值是nodesRef对应的selectorQuery。

返回的节点信息中，每个节点的滚动位置用scrollLeft、scrollHeight字段描述。如果提供了callback回调函数，在执行selectQuery的exec方法后，节点信息会在callback中返回。

示例代码：

Page({  getScrollOffset: function(){    wx.createSelectorQuery().selectViewport().scrollOffset(function(res){      res.id      // 节点的ID      res.dataset // 节点的dataset      res.scrollLeft // 节点的水平滚动位置      res.scrollTop  // 节点的竖直滚动位置    }).exec()  }})

nodesRef.fields(fields, [callback])

---

获取节点的相关信息，需要获取的字段在fields中指定。返回值是nodesRef对应的selectorQuery。可指定获取的字段包括：

示例代码：

Page({  getFields: function(){    wx.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()  }})

selectorQuery.exec([callback])

---

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