# 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