- JS API 列表
- 基础
- 网络
- 媒体
- 地图
- 文件
- 开放接口
- 数据缓存
- 地理位置
- 设备
- 画布
- 界面
- 页面导航
- 侧边栏能力
- 行业开放
- AI/AR能力
- 第三方平台
- TTML
- 转发和挂载
- 其它
- 直播能力
tt.getCustomButtonBoundingClientRect收藏我的收藏
收藏
我的收藏获取自定义导航栏下不可改变的元素(左上角 logo 或 返回按钮 以及 右上角反馈、更多、关闭按钮)的位置信息。坐标信息以屏幕左上角为原点。
语法
text复制tt.getCustomButtonBoundingClientRect(options)
参数说明
options
为 object 类型,属性如下:
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
measurementUnit | string | px | 否 | 设置返回值的单位,支持px、rpx | 3.38.0 |
返回值
返回 object 类型数据,属性如下:
属性 | 类型 | 说明 | 最低支持版本 |
leftIcon | object | 左上角 logo/返回的位置信息 | 2.42.0 |
capsule | object | 右上角反馈+more+close 的位置信息 | 2.42.0 |
customNavigation | object | 自定义导航栏可绘制区域 | 3.38.0 |
leftIcon 的属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
width | number | 宽度 | 2.42.0 |
height | number | 高度 | 2.42.0 |
top | number | 上边界坐标 | 2.42.0 |
right | number | 右边界坐标 | 2.42.0 |
bottom | number | 下边界坐标 | 2.42.0 |
left | number | 左边界坐标 | 2.42.0 |
capsule 的属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
width | number | 宽度 | 2.42.0 |
height | number | 高度 | 2.42.0 |
top | number | 上边界坐标 | 2.42.0 |
right | number | 右边界坐标 | 2.42.0 |
bottom | number | 下边界坐标 | 2.42.0 |
left | number | 左边界坐标 | 2.42.0 |
customNavigation 的属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
width | number | 自定义导航栏可绘制区域的宽度 | 3.38.0 |
height | number | 自定义导航栏可绘制区域的高度 | 3.38.0 |
marginLeft | number | 自定义导航栏可绘制区域距离可使用窗口的左边距 | 3.38.0 |
marginRight | number | 自定义导航栏可绘制区域距离可使用窗口的右边距 | 3.38.0 |
marginTop | number | 自定义导航栏可绘制区域距离可使用窗口的上边距 | 3.38.0 |
centerLineToTop | number | 中线和顶部的距离 | 3.38.0 |
扫码体验
代码示例
Bug & Tip
- •仅在自定义导航栏下调用该 api 才返回真实数据。默认导航栏下调用该 api 返回调用失败。
- •仅在真实显示的时候才返回数据(如左上角无组件,则不返回 leftIcon 相关数据)
- •x 分屏情况下返回 x 分屏还原 100% 全屏时候的样式布局信息。
点击纠错