分类： 界面

wx.onWindowResize(function listener)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

功能描述

监听窗口尺寸变化事件

参数

function listener

窗口尺寸变化事件的监听函数

参数

Object res
属性 类型 说明
size Object
结构属性 类型 说明
windowWidth number 变化后的窗口宽度，单位 px
windowHeight number 变化后的窗口高度，单位 px

wx.onWindowStateChange(function listener)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

功能描述

监听微信小程序窗口状态变化事件。仅适用于 PC 平台

参数

function listener

微信小程序窗口状态变化事件的监听函数

参数

Object res
属性 类型 说明
state string 改变的窗口状态，可能的值为：
  • ‘minimize’：窗口最小化
  • ‘normalize’：窗口恢复正常尺寸
  • ‘maximize’：窗口最大化 |

wx.setWindowSize(Object object)

从基础库 2.11.0 开始，本接口停止维护

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

以 Promise 风格 调用：不支持

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

功能描述

设置窗口大小，该接口仅适用于 PC 平台，使用细则请参见指南

参数

Object object

属性 类型 默认值 必填 说明
width number 是 窗口宽度，以像素为单位
height number 是 窗口高度，以像素为单位
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

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)