# boundingClientRect
添加节点的布局位置的查询请求。相对于显示区域,以像素为单位。其功能类似于 DOM 的 getBoundingClientRect
。返回 nodesRef
对应的 SelectorQuery
。如果提供了 callback
回调函数,在执行 selectQuery.exec
方法后,节点信息会在 callback
中返回。
# 支持说明
应用能力 | Android | iOS | PC | 预览效果 |
---|---|---|---|---|
小程序 | 3.0.0 | 3.0.0 | 3.2.0 | 待补充 |
网页应用 | X | X | X | 待补充 |
# 输入
名称 | 数据类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
callback | function | 是 | 该事件的回调函数 |
# 输出
回调函数返回对象的属性
名称 | 数据类型 | 描述 |
---|---|---|
id | string | 节点id |
dataset | object | 节点的dataset |
left | number | 节点的左边界坐标 |
right | number | 节点的右边界坐标 |
top | number | 节点的上边界坐标 |
bottom | number | 节点的下边界坐标 |
width | number | 节点的宽度 |
height | number | 节点的高度 |
# 代码示例
let view = bz.createSelectorQuery().in(this).select(".test");
view.boundingClientRect(data => {
console.log("得到布局位置信息" + JSON.stringify(data));
console.log("节点离页面顶部的距离为" + data.top);
}).exec();
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8