微信小程序API WXML节点信息

由 youj 创建， 最后一次修改 2017-08-16 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 // 显示区域的竖直滚动位置 }) }})selectorQueryselectorQuery 对象的方法列表：方法参数说明selectselector参考下面详细介绍selectAllselector参考下面详细介绍selectViewport 参考下面详细介绍exec[callback]参考下面详细介绍selectorQuery.select(selector)在当前页面下选择第一个匹配选择器selector的节点，返回一个NodesRef对象实例，可以用于获取节点信息。selector类似于CSS的选择器，但仅支持下列语法。ID选择器：#the-idclass选择器（可以连续指定多个）：.a-class.another-class子元素选择器：.the-parent > #the-child.a-class多选择器的并集：#a-node, .some-other-nodesselectorQuery.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。可指定获取的字段包括：字段名默认值说明id否是否返回节点iddataset否是否返回节点datasetrect否是否返回节点布局位置（left right top bottom）size否是否返回节点尺寸（width height）scrollOffset否是否返回节点的 scrollLeft scrollTop ，节点必须是scroll-view或者viewportproperties[]指定属性名列表，返回节点对应属性名的当前属性值（只能获得组件文档中标注的常规属性值， id class style 和事件绑定的属性值不可获取）示例代码：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的第一个参数中返回。