开发
API

tt.getCustomButtonBoundingClientRect

基础库 2.42.0 开始支持本方法,低版本需做兼容处理,这是一个同步方法。

获取自定义导航栏下不可改变的元素(比如左上角 logo/返回位置+ 右上角反馈+more+close)的位置信息。坐标信息以屏幕左上角为原点。

语法

tt.getCustomButtonBoundingClientRect()

参数说明

返回值

返回 object 类型数据,属性如下:

属性类型说明最低支持版本
leftIconobject左上角 logo/返回的位置信息2.42.0
capsuleobject右上角反馈+more+close 的位置信息2.42.0

leftIcon 的属性如下:

属性名类型说明最低支持版本
widthnumber宽度,单位:px2.42.0
heightnumber高度,单位:px2.42.0
topnumber上边界坐标,单位:px2.42.0
rightnumber右边界坐标,单位:px2.42.0
bottomnumber下边界坐标,单位:px2.42.0
leftnumber左边界坐标,单位:px2.42.0

capsule 的属性如下:

属性名类型说明最低支持版本
widthnumber宽度,单位:px2.42.0
heightnumber高度,单位:px2.42.0
topnumber上边界坐标,单位:px2.42.0
rightnumber右边界坐标,单位:px2.42.0
bottomnumber下边界坐标,单位:px2.42.0
leftnumber左边界坐标,单位:px2.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%全屏时候的样式布局信息。
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助