智能小程序基础API——应用级事件汇总

ty.onAppShow

监听小程序切前台事件。该事件与 App.onShow 的回调参数一致。

function callback

小程序切前台事件的回调函数

ty.offAppShow

取消监听小程序切前台事件

参数

function callback

取消监听小程序切前台事件的回调函数

ty.onAppHide

监听小程序切后台事件。该事件与 App.onHide 的回调时机一致。

function callback

小程序切后台事件的回调函数

ty.offAppHide

取消监听小程序切后台事件

参数

function callback

取消监听小程序切后台事件的回调函数

ty.onWindowResize

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

功能描述

监听窗口尺寸变化事件

function callback

窗口尺寸变化事件的回调函数

名称	类型	说明
type	string	portrait landscape
size.windowWidth	Number	屏幕宽度, 单位 px
size.windowHeight	Number	屏幕高度, 单位 px

复制代码

ty.onWindowResize(function (res) {
  console.log(res.type);
  console.log(res.size.windowWidth);
  console.log(res.size.windowHeight);
});

ty.offWindowResize

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

功能描述

取消监听窗口尺寸变化事件

function callback

窗口尺寸变化事件的回调函数

ty.onError

监听小程序错误事件。如脚本错误或 API 调用报错等。该事件与 App.onError 的回调时机与参数一致。

function callback

小程序错误事件的回调函数

ty.offError

取消监听小程序错误事件。

function callback

小程序错误事件的回调函数

ty.onAppEvent

基础库 >= 2.4.2

点击看板的时候触发事件, 参数对应点击的 boardMenus 中的对象。

function callback

小程序自定义事件回调

ty.offAppEvent

基础库 >= 2.4.2

取消监听点击看板的时候触发事件

function callback

小程序自定义事件回调

ty.onThemeChange(function callback)

监听主题变更事件，仅在 darkmode 开启时有效。

参数

function callback

监听主题变更事件的回调函数

ty.offThemeChange(function callback)

取消监听主题变更事件

参数

function callback

取消监听主题变更事件的回调函数

ty.onPageNotFound(function callback)

监听小程序要打开的页面不存在事件。该事件与 App.onPageNotFound 的回调时机一致。

参数

function callback

小程序要打开的页面不存在事件的回调函数

属性	类型	说明
url	string	不存在页面的路径
query	Object	打开不存在页面的 query 参数