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)