wx.onParallelStateChange(function listener)

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

微信小程序插件:不支持

微信 Windows 版:支持

微信 Mac 版:支持

功能描述

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

参数

function listener

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

参数

Object res
属性 类型 说明
isOnParallel boolean 当前是否分栏
rightPage Page 分栏右侧页面对象(非分栏状态时返回当前页面)
leftPage Page 分栏左侧页面对象(非分栏状态时返回当前页面)

wx.onWindowResize(function listener)

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

微信小程序插件:不支持

微信 Windows 版:支持

微信 Mac 版:支持

微信 鸿蒙 OS 版:支持

功能描述

监听窗口尺寸变化事件

参数

function listener

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

参数

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

wx.openPhotoTopicView(Object object)

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

以 Promise 风格 调用:不支持

微信小程序插件:不支持

功能描述

打开微信官方图片话题发布页。

参数

Object object

属性 类型 默认值 必填 说明
queryString string 否 附加的查询字符串,必须是 key1=val1&key2=val2 的格式。
extraData Object 否 传递给目标业务微信小程序的业务参数。
envVersion string release 否 要打开的微信小程序版本。
合法值 说明
develop 开发版
trial 体验版
release 正式版
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数
Object res
属性 类型 说明
extraData Object 图片话题发布页返回的业务数据(结构由微信官方业务约定)

object.fail 回调函数

参数
Object err
属性 类型 说明
errMsg string 错误信息

示例代码

wx.openPhotoTopicView({
  extraData: {
    // 由目标业务约定的字段
    foo: 'bar',
  },
  success(res) {
    console.log(res)
  },
  fail(err) {
    console.error(err)
  },
})

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)