switchTab
该 API 使用方法为 wx.switchTab(Object object)
功能说明:跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面。
参数及说明:Object object。
属性 | 类型 | 默认值 | 必填 | 说明 |
url | string | - | 是 | 需要跳转的 tabBar 页面的路径 (代码包路径)(需在 app.json 的 tabBar 字段定义的页面),路径后不能带参数 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用成功的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码:
// app.json{"tabBar": {"list": [{"pagePath": "index","text": "首页"},{"pagePath": "other","text": "其他"}]}}
wx.switchTab({url: '/index'})
reLaunch
该 API 使用方法为 wx.reLaunch(Object object)
功能说明:关闭所有页面,打开到应用内的某个页面。
参数及说明:Object object。
属性 | 类型 | 默认值 | 必填 | 说明 |
url | string | - | 是 | 需要跳转的应用内非 tabBar 的页面的路径 (代码包路径),路径后可以带参数。参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔;如 'path?key=value&key2=value2' |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码:
wx.redirectTo({url: 'test?id=1'})
redirectTo
该 API 使用方法为 wx.redirectTo(Object object)
功能说明:关闭所有页面,打开到应用内的某个页面。
参数及说明:Object object。
属性 | 类型 | 默认值 | 必填 | 说明 |
url | string | - | 是 | 需要跳转的应用内页面路径 (代码包路径),路径后可以带参数。参数与路径之间使用 ? 分隔,参数键与参数值用=相连,不同参数用& 分隔;如 'path?key=value&key2=value2' |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码:
wx.reLaunch({url: 'test?id=1'})
// testPage({onLoad (option) {console.log(option.query)}})
navigateTo
该 API 使用方法为 wx.navigateTo(Object object)
功能说明:保留当前页面,跳转到应用内的某个页面,但是不能跳到 tabbar 页面。使用 wx.navigateBack 可以返回到原页面,小程序中页面栈最多十层。
参数及说明:Object object。
属性 | 类型 | 默认值 | 必填 | 说明 |
url | string | - | 是 | 需要跳转的应用内非 tabBar 的页面的路径 (代码包路径), 路径后可以带参数。参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔;如 'path?key=value&key2=value2' |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码:
wx.navigateTo({url: 'test?id=1',})//test.jsPage({onLoad: (option){console.log(option.query)}})
navigateBack
该 API 使用方法为 wx.navigateBack(Object object)
功能说明:关闭当前页面,返回上一页面或多级页面。
参数及说明:Object object。
属性 | 类型 | 默认值 | 必填 | 说明 |
delta | number | 1 | 否 | 返回的页面数,如果 delta 大于现有页面数,则返回到首页 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码:
// 注意:调用 navigateTo 跳转时,调用该方法的页面会被加入堆栈,而 redirectTo 方法则不会。见下方示例代码// 此处是 A 页面wx.navigateTo({url: 'B?id=1'})// 此处是 B 页面wx.navigateTo({url: 'C?id=1'})// 在 C 页面内 navigateBack,将返回 A 页面wx.navigateBack({delta: 2})
EventChannel
页面间事件通信通道。
EventChannel.emit
该 方法 使用方式为 EventChannel.emit(string eventName, any args)
功能说明:触发一个事件。
参数及说明:string eventName,事件名称;any args,事件参数。
EventChannel.off
该 方法 使用方式为 EventChannel.off(string eventName, EventCallback fn)
功能说明:取消监听一个事件。给出第二个参数时,只取消给出的监听函数,否则取消所有监听函数,使用方法为 EventChannel.off(string eventName, function fn)。
参数及说明:string eventName,事件名称;function fn,事件监听函数;any args,触发事件参数。
EventChannel.on
该 方法 使用方式为 EventChannel.on(string eventName, EventCallback fn)
功能说明:持续监听一个事件,使用方法为 EventChannel.on(string eventName, function fn)。
参数及说明:string eventName,事件名称;function fn,事件监听函数;any args,触发事件参数。
EventChannel.once
该 方法 使用方式为 EventChannel.once(string eventName, EventCallback fn)
功能说明:监听一个事件一次,触发后失效,使用方法为 EventChannel.once(string eventName, function fn)。
参数及说明:string eventName,事件名称;function fn,事件监听函数;any args,触发事件参数。