分类： 菜单

Object wx.getMenuButtonBoundingClientRect()

基础库 2.1.0 开始支持，低版本需做兼容处理。

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.15.0

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

功能描述

获取菜单按钮（右上角胶囊按钮）的布局位置信息。坐标信息以屏幕左上角为原点。

返回值

Object

菜单按钮的布局位置信息

属性 类型 说明
width number 宽度，单位：px
height number 高度，单位：px
top number 上边界坐标，单位：px
right number 右边界坐标，单位：px
bottom number 下边界坐标，单位：px
left number 左边界坐标，单位：px

示例代码

const res = wx.getMenuButtonBoundingClientRect()

console.log(res.width)
console.log(res.height)
console.log(res.top)
console.log(res.right)
console.log(res.bottom)
console.log(res.left)

wx.offMenuButtonBoundingClientRectWeightChange(function listener)

基础库 3.4.3 开始支持，低版本需做兼容处理。

微信小程序插件：不支持

微信 Windows 版：支持

微信 鸿蒙 OS 版：支持

功能描述

移除菜单按钮（右上角胶囊按钮）的布局位置信息变化事件的监听函数

参数

function listener

onMenuButtonBoundingClientRectWeightChange 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

wx.onMenuButtonBoundingClientRectWeightChange(listener)
wx.offMenuButtonBoundingClientRectWeightChange(listener) // 需传入与监听时同一个的函数对象

wx.offUserOffTranslation(function listener)

基础库 3.14.2 开始支持，低版本需做兼容处理。

微信小程序插件：不支持

微信 Windows 版：支持

微信 鸿蒙 OS 版：支持

功能描述

移除用户主动取消翻译的事件的监听函数

参数

function listener

onUserOffTranslation 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

wx.onUserOffTranslation(listener)
wx.offUserOffTranslation(listener) // 需传入与监听时同一个的函数对象

wx.offUserTriggerTranslation(function listener)

基础库 3.7.9 开始支持，低版本需做兼容处理。

微信小程序插件：不支持

微信 Windows 版：支持

微信 鸿蒙 OS 版：支持

功能描述

移除用户触发微信小程序菜单中翻译功能的事件的监听函数

参数

function listener

onUserTriggerTranslation 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

wx.onUserTriggerTranslation(listener)
wx.offUserTriggerTranslation(listener) // 需传入与监听时同一个的函数对象

wx.onMenuButtonBoundingClientRectWeightChange(function listener)

基础库 3.4.3 开始支持，低版本需做兼容处理。

微信小程序插件：不支持

微信 Windows 版：支持

微信 鸿蒙 OS 版：支持

功能描述

监听菜单按钮（右上角胶囊按钮）的布局位置信息变化事件

参数

function listener

菜单按钮（右上角胶囊按钮）的布局位置信息变化事件的监听函数

参数

Object res
属性 类型 说明
width number 宽度，单位：px
height number 高度，单位：px
top number 上边界坐标，单位：px
right number 右边界坐标，单位：px
bottom number 下边界坐标，单位：px
left number 左边界坐标，单位：px

示例代码

const callback = res => console.log('menuButtonBoundingClientRectWeightChange', res)

wx.onMenuButtonBoundingClientRectWeightChange(callback)
// 取消监听
wx.offMenuButtonBoundingClientRectWeightChange(callback)

wx.onUserOffTranslation(function listener)

基础库 3.14.2 开始支持，低版本需做兼容处理。

微信小程序插件：不支持

微信 Windows 版：支持

微信 鸿蒙 OS 版：支持

功能描述

监听用户主动取消翻译的事件

参数

function listener

用户主动取消翻译的事件的监听函数

示例代码

const callback = () => console.log('userTriggerTranslation')

wx.onUserOffTranslation(callback)
// 取消监听
wx.offUserOffTranslation(callback)

wx.onUserTriggerTranslation(function listener)

基础库 3.7.9 开始支持，低版本需做兼容处理。

微信小程序插件：不支持

微信 Windows 版：支持

微信 鸿蒙 OS 版：支持

功能描述

监听用户触发微信小程序菜单中翻译功能的事件

参数

function listener

用户触发微信小程序菜单中翻译功能的事件的监听函数

参数

Object res
属性 类型 说明
locale string 翻译到的目标语言
type string 触发来源， button 表示点击了菜单中的翻译按钮， capsule 表示点击了胶囊中的翻译提示

示例代码

const callback = res => console.log('userTriggerTranslation', res)

wx.onUserTriggerTranslation(callback)
// 取消监听
wx.offUserTriggerTranslation(callback)