tt.getCustomButtonBoundingClientRect
基础库 2.42.0 开始支持本方法,低版本需做兼容处理,这是一个同步方法。
获取自定义导航栏下不可改变的元素(比如左上角 logo/返回位置+ 右上角反馈+more+close)的位置信息。坐标信息以屏幕左上角为原点。
语法
tt.getCustomButtonBoundingClientRect()
参数说明
无
返回值
返回 object 类型数据,属性如下:
属性 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
leftIcon | object | 左上角 logo/返回的位置信息 | 2.42.0 |
capsule | object | 右上角反馈+more+close 的位置信息 | 2.42.0 |
leftIcon 的属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
width | number | 宽度,单位:px | 2.42.0 |
height | number | 高度,单位:px | 2.42.0 |
top | number | 上边界坐标,单位:px | 2.42.0 |
right | number | 右边界坐标,单位:px | 2.42.0 |
bottom | number | 下边界坐标,单位:px | 2.42.0 |
left | number | 左边界坐标,单位:px | 2.42.0 |
capsule 的属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
width | number | 宽度,单位:px | 2.42.0 |
height | number | 高度,单位:px | 2.42.0 |
top | number | 上边界坐标,单位:px | 2.42.0 |
right | number | 右边界坐标,单位:px | 2.42.0 |
bottom | number | 下边界坐标,单位:px | 2.42.0 |
left | number | 左边界坐标,单位:px | 2.42.0 |
代码示例
const res = tt.getCustomButtonBoundingClientRect();
console.log("左上角logo/返回的位置信息:" + res.leftIcon);
console.log("右上角反馈+more+close的位置信息:" + res.capsule);
Bug & Tip
- Tip:只在自定义导航栏下调用该 api 才返回真实数据。默认导航栏下调用该 api 返回调用失败;
- Tip:只在真实显示的时候才返回数据(如左上角无组件,则不返回 leftIcon 相关数据);x 分屏情况下返回 x 分屏还原 100%全屏时候的样式布局信息。
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助