微信小程序开发获取界面上的节点信息
在微信小程序的开发中,获取界面上的节点信息是一个非常重要的功能。通过节点信息查询 API,我们可以轻松地获取节点属性、样式、以及在界面上的位置等信息。最常见的用法是使用这个接口来查询某个节点的当前位置,以及界面的滚动位置。
1. 使用节点查询 API 获取节点信息
使用 wx.createSelectorQuery() 可以创建 SelectorQuery 对象,该对象有以下方法:
- select(selector): 在当前页面下选择第一个匹配选择器 selector 的节点,并返回单个 NodeInfo 对象实例。
- selectAll(selector): 在当前页面下选择多个匹配选择器 selector 的节点,并返回 NodeList 对象实例。
- selectViewport(): 以显示区域作为参照,返回 ViewportRect 对象实例。
- exec(callback): 执行所有已添加的请求并收集结果,回调函数会被传入所有请求的结果。
示例代码如下:
const query = wx.createSelectorQuery()
query.select('#the-id').boundingClientRect(function(res){
res.top // #the-id 节点的上边界坐标(相对于显示区域)
})
query.selectViewport().scrollOffset(function(res){
res.scrollTop // 显示区域的竖直滚动位置
})
query.exec()
上述代码中,#the-id 是一个节点选择器,在自定义组件或包含自定义组件的页面中,推荐使用 this.createSelectorQuery() 来代替 wx.createSelectorQuery(),这样可以确保在正确的范围内选择节点。
2. 使用节点布局相交状态 API 监听节点状态
使用节点布局相交状态 API 可以监听两个或多个组件节点在布局位置上的相交状态,这一组API常常可以用于推断某些节点是否可以被用户看见、有多大比例可以被用户看见。
使用 wx.createIntersectionObserver() 可以创建 IntersectionObserver 对象,该对象有以下方法:
- relativeTo(selector): 指定参照节点,在它的布局区域内才会触发相交状态变化事件。
- relativeToViewport(): 以显示区域作为参照,可以观测到目标节点在显示区域内的相交状态变化。
- observe(selector, callback): 开始监听相交状态变化,当某个目标节点的相交状态变化时,就会执行回调函数。
- disconnect(): 停止监听相交状态变化。
- relativeToSelectorQuery(query): 用于指定选择器查询实例作为参照区域之一。
下面是一个示例代码,可以在目标节点每次进入或离开页面显示区域时,触发回调函数:
Page({
onLoad: function(){
wx.createIntersectionObserver().relativeToViewport().observe('.target-class', (res) => {
res.id // 目标节点 id
res.dataset // 目标节点 dataset
res.intersectionRatio // 相交区域占目标节点的布局区域的比例
res.intersectionRect // 相交区域
res.intersectionRect.left // 相交区域的左边界坐标
res.intersectionRect.top // 相交区域的上边界坐标
res.intersectionRect.width // 相交区域的宽度
res.intersectionRect.height // 相交区域的高度
})
}
})
下面是另一个示例代码,可以在目标节点与参照节点在页面显示区域内相交或相离,且相交或相离程度达到目标节点布局区域的20%和50%时,触发
-
B2B2C多用户商城系统支持企业自营与商户入驻模式共存 会员一站式精细化营销工具 多用户分销,带来爆发式增长
系统支持平台自营+供应商店铺共存的经营模式(类天猫&京东模式),帮助企业打造生态级商业平台为目的的电子商务系统。
免费试用系统 -
B2B2B电商交易系统优化供应链协作 授信及账期支付 商品按照数量阶梯设价
全渠道订货/采购及经销商管理数字化系统,实现供应链整合和交易便捷化。
免费试用系统 -
S2B2B电商交易系统供销一体化,提高市场集中度 集团管控一体化,有效实现供需匹配 移动应用一体化,提高运营综合效率
上下游资源整合数字化解决方案,赋能产业供应链,构建产业互联网生态体系。
免费试用系统
