From 5f2fcb5c4e5ea5d7f0cf46d08bd31ad93bde7947 Mon Sep 17 00:00:00 2001 From: wangyaqi Date: Fri, 6 Sep 2019 20:00:50 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9getMenuButtonBounding?= =?UTF-8?q?ClientRect=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api/ui/menuButton.md | 30 ++++++++++++++++++++++++------ 1 file changed, 24 insertions(+), 6 deletions(-) diff --git a/docs/api/ui/menuButton.md b/docs/api/ui/menuButton.md index 3833cef7af..6969358631 100644 --- a/docs/api/ui/menuButton.md +++ b/docs/api/ui/menuButton.md @@ -2,12 +2,30 @@ 在小程序平台,如果原生导航栏被隐藏,仍然在右上角会有一个悬浮按钮,微信下也被称为胶囊按钮。本API用于获取小程序下该菜单按钮的布局位置信息,方便开发者布局顶部内容时避开该按钮。 -坐标信息以屏幕左上角为原点。 +坐标信息以屏幕左上角为原点。 + +**平台差异说明** + +|5+App|H5 |微信小程序 |支付宝小程序 |百度小程序 |头条小程序 |QQ小程序 | +|:-: |:-:|:-: |:-: |:-: |:-: |:-: | +|x |x |√ |x |√ |√ |√ | + +**返回值说明** + +|属性 |类型 |说明 | +|width |number |宽度,单位:px | +|height |number |高度,单位:px | +|top |number |上边界坐标,单位:px | +|right |number |右边界坐标,单位:px | +|bottom |number |下边界坐标,单位:px | +|left |number |左边界坐标,单位:px | + +**示例** + +```javascript + let menuButtonInfo = uni.getMenuButtonBoundingClientRect() +``` -各平台开发方式暂未统一,使用时需注意用[条件编译](https://uniapp.dcloud.io/platform)调用不同平台的代码。 +**注意** -- 微信小程序:[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/wx.getMenuButtonBoundingClientRect.html) -- 百度小程序:[规范详情](https://smartprogram.baidu.com/docs/develop/api/menu_info/) - 支付宝小程序:其逻辑与微信小程序不同,它提供了菜单点击后按钮的自定义功能,可以选择显示那些系统按钮,[规范详情](https://docs.alipay.com/mini/api/optionmenuitem) -- 头条小程序:[规范详情](https://developer.toutiao.com/docs/game/ui/menu/tt.getMenuButtonBoundingClientRect.html) -- QQ小程序:[规范详情](https://q.qq.com/wiki/develop/game/API/interface/menu.html#qq-getmenubuttonboundingclientrect) -- GitLab