该 API 使用方法为 SelectorQuery wx.createSelectorQuery()
this.createSelectorQuery()
来代替。const query = wx.createSelectorQuery()query.select('#the-id').boundingClientRect()query.selectViewport().scrollOffset()query.exec(function (res) {res[0].top // #the-id节点的上边界坐标res[1].scrollTop // 显示区域的竖直滚动位置})
该 API 使用方法为 IntersectionObserver wx.createIntersectionObserver(Object component, Object options)
this.createIntersectionObserver([options])
来代替。属性 | 类型 | 默认值 | 必填 | 说明 |
thresholds | Array.<number> | [0] | 否 | 一个数值数组,包含所有阈值。 |
initialRatio | number | 0 | 否 | 初始的相交比例,如果调用时检测到的相交比例与这个值不相等且达到阈值,则会触发一次监听器的回调函数。 |
observeAll | boolean | false | 否 | 是否同时观测多个目标节点(而非一个),如果设为 true ,observe 的 targetSelector 将选中多个节点(注意:同时选中过多节点将影响渲染性能)。 |
该 方法 使用方式为 IntersectionObserver.relativeTo(string selector, Object margins)
属性 | 类型 | 默认值 | 必填 | 说明 |
left | number | - | 否 | 节点布局区域的左边界 |
right | number | - | 否 | 节点布局区域的右边界 |
top | number | - | 否 | 节点布局区域的上边界 |
bottom | number | - | 否 | 节点布局区域的下边界 |
该 方法 使用方式为 IntersectionObserver.relativeToViewport(Object margins)
属性 | 类型 | 默认值 | 必填 | 说明 |
left | number | - | 否 | 节点布局区域的左边界 |
right | number | - | 否 | 节点布局区域的右边界 |
top | number | - | 否 | 节点布局区域的上边界 |
bottom | number | - | 否 | 节点布局区域的下边界 |
Page({onLoad: function(){wx.createIntersectionObserver().relativeToViewport({bottom: 100}).observe('.target-class', (res) => {res.intersectionRatio // 相交区域占目标节点的布局区域的比例res.intersectionRect // 相交区域res.intersectionRect.left // 相交区域的左边界坐标res.intersectionRect.top // 相交区域的上边界坐标res.intersectionRect.width // 相交区域的宽度res.intersectionRect.height // 相交区域的高度})}})
该 方法 使用方式为 IntersectionObserver.disconnect()
该 方法 使用方式为 IntersectionObserver.observe(string targetSelector, function callback)
属性 | 类型 | 说明 |
intersectionRatio | number | 相交比例 |
object | 相交区域的边界 | |
object | 目标边界 | |
object | 参照区域的边界 | |
time | number | 相交检测时的时间戳 |
结构属性 | 类型 | 说明 |
left | number | 左边界 |
right | number | 右边界 |
top | number | 上边界 |
bottom | number | 下边界 |
width | number | 宽度 |
height | number | 高度 |
结构属性 | 类型 | 说明 |
left | number | 左边界 |
right | number | 右边界 |
top | number | 上边界 |
bottom | number | 下边界 |
width | number | 宽度 |
height | number | 高度 |
结构属性 | 类型 | 说明 |
left | number | 左边界 |
right | number | 右边界 |
top | number | 上边界 |
bottom | number | 下边界 |
该 方法 使用方式为 NodesRef.fields(Object fields, function callback)
nodesRef
对应的 selectorQuery
属性 | 类型 | 默认值 | 必填 | 说明 |
id | boolean | false | 否 | 是否返回节点 id |
dataset | boolean | false | 否 | 是否返回节点 dataset |
rect | boolean | false | 否 | 是否返回节点布局位置( left 、right 、top 、bottom ) |
size | boolean | false | 否 | 是否返回节点尺寸( width 、height ) |
scrollOffset | boolean | false | 否 | 是否返回节点的 scrollLeft scrollTop ,节点必须是 scroll-view 或者 viewport |
properties | Array.<string> | [] | 否 | 指定属性名列表,返回节点对应属性名的当前属性值(只能获得组件文档中标注的常规属性值,id class style 和事件绑定的属性值不可获取) |
computedStyle | Array.<string> | [] | 否 | 指定样式名列表,返回节点对应样式名的当前值 |
context | boolean | false | 否 | 是否返回节点对应的 Context 对象 |
Page({getFields () {wx.createSelectorQuery().select('#the-id').fields({dataset: true,size: true,scrollOffset: true,properties: ['scrollX', 'scrollY'],computedStyle: ['margin', 'backgroundColor'],context: true,}, function (res) {res.dataset // 节点的datasetres.width // 节点的宽度res.height // 节点的高度res.scrollLeft // 节点的水平滚动位置res.scrollTop // 节点的竖直滚动位置res.scrollX // 节点 scroll-x 属性的当前值res.scrollY // 节点 scroll-y 属性的当前值// 此处返回指定要返回的样式名res.marginres.backgroundColorres.context // 节点对应的 Context 对象res.ref // 节点对应的 Ref 对象}).exec()}})
该 方法 使用方式为 SelectorQuery NodesRef.boundingClientRect(function callback)
getBoundingClientRect
。callback
中返回。属性 | 类型 | 说明 |
id | string | 节点的 ID |
dataset | Object | 节点的 dataset |
left | number | 节点的左边界坐标 |
right | number | 节点的右边界坐标 |
top | number | 节点的上边界坐标 |
bottom | number | 节点的下边界坐标 |
width | number | 节点的宽度 |
height | number | 节点的高度 |
Page({getRect() {wx.createSelectorQuery().select('#the-id').boundingClientRect(function (rect) {rect.id // 节点的IDrect.dataset // 节点的datasetrect.left // 节点的左边界坐标rect.right // 节点的右边界坐标rect.top // 节点的上边界坐标rect.bottom // 节点的下边界坐标rect.width // 节点的宽度rect.height // 节点的高度}).exec()},getAllRects() {wx.createSelectorQuery().selectAll('.a-class').boundingClientRect(function (rects) {rects.forEach(function (rect) {rect.id // 节点的IDrect.dataset // 节点的datasetrect.left // 节点的左边界坐标rect.right // 节点的右边界坐标rect.top // 节点的上边界坐标rect.bottom // 节点的下边界坐标rect.width // 节点的宽度rect.height // 节点的高度})}).exec()}})
该 方法 使用方式为 SelectorQuery NodesRef.scrollOffset(function callback)
scroll-view
或者viewport
。属性 | 类型 | 说明 |
id | string | 节点的 ID |
dataset | Object | 节点的 dataset |
scrollLeft | number | 节点的水平滚动位置 |
scrollTop | number | 节点的竖直滚动位置 |
Page({getScrollOffset() {wx.createSelectorQuery().selectViewport().scrollOffset(function (res) {res.id // 节点的IDres.dataset // 节点的datasetres.scrollLeft // 节点的水平滚动位置res.scrollTop // 节点的竖直滚动位置}).exec()}})
该 方法 使用方式为 SelectorQuery NodesRef.context(function callback)
属性 | 类型 | 说明 |
context | Object | 节点对应的 Context 对象 |
Page({getContext() {wx.createSelectorQuery().select('.the-map-class').context(function (res) {console.log(res.context) // 节点对应的 Context 对象。如:选中的节点是 <map> 组件,那么此处即返回 MapContext 对象}).exec()}})
该 方法 使用方式为 SelectorQuery NodesRef.node(function callback)
属性 | 类型 | 说明 |
node | Object | 节点对应的 Node 实例 |
Page({getNode() {wx.createSelectorQuery().select('.canvas').node(function(res){console.log(res.node) // 节点对应的 Canvas 实例。}).exec()}})
该 方法 使用方式为 NodesRef SelectorQuery.exec(function callback)
该 方法 使用方式为 SelectorQuery SelectorQuery.in(Component component)
component
内。(初始时,选择器仅选取页面范围的节点,不会选取任何自定义组件中的节点)。Component({queryMultipleNodes() {const query = wx.createSelectorQuery().in(this)query.select('#the-id').boundingClientRect(function (res) {res.top // 这个组件内 #the-id 节点的上边界坐标}).exec()}})
该 方法 使用方式为 NodesRef SelectorQuery.select(string selector)
selector
的节点。返回一个 NodesRef
对象实例,可以用于获取节点信息。该 方法 使用方式为 NodesRef SelectorQuery.selectAll(string selector)
该 方法 使用方式为 NodesRef SelectorQuery.selectViewport()
该 方法 使用方式为 MediaQueryObserver.disconnect()
该 方法 使用方式为 MediaQueryObserver.observe(Object descriptor, function callback)
属性 | 类型 | 默认值 | 必填 | 说明 |
minWidth | number | - | 是 | 页面最小宽度( px 为单位) |
maxWidth | number | - | 是 | 页面最大宽度( px 为单位) |
width | number | - | 是 | 页面宽度( px 为单位) |
minHeight | number | - | 是 | 页面最小高度( px 为单位) |
maxHeight | number | - | 是 | 页面最大高度( px 为单位) |
height | number | - | 是 | 页面高度( px 为单位) |
orientation | string | - | 是 | 屏幕方向( landscape 或 portrait ) |
属性 | 类型 | 说明 |
matches | boolean | 页面的当前状态是否满足所指定的 media query |
本页内容是否解决了您的问题?