跳轉
exitMiniProgram
TIP
該API使用方法為: wx.exitMiniProgram(Object object)
- 功能說明: 退出當前小程序。 必須有按一下行為才能調用成功。
- 參數及說明: Object object。
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數(無論成功與否都執行) |
navigateToMiniProgram
TIP
該API使用方法為: wx.navigateToMiniProgram(Object object)
- 功能說明: 打開另一個小程序
- 參數及說明: Object object。
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| appId | string | - | 是 | 要打開的小程序appId |
| path | string | - | 否 | 打開的頁面路徑,如果為空則打開首頁, path中? 後面的部分會成為query,在小程序的 App.onLaunch,App.onShow Page.onLoad 的回呼函數或 wx.getLaunchOptionsSync中可以獲取到query數據 |
| extraData | object | - | 否 | 需要傳遞給目標小程序的數據,目標小程序可在App.onLaunch,App.onShow中獲取到這份數據 |
| envVersion | string | release | 否 | 要打開的小程序版本。 僅在當前小程序為開發版或體驗版時此參數有效。 如果當前小程序是正式版,則打開的小程序必定是正式版,其合法值如下: 1.develop: 開發版 2trial: 體驗版 3.release: 正式版 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數(無論成功與否都執行) |
使用限制。
需要用戶觸發跳轉
若用戶未按一下小程序頁面任意位置,則開發者將無法調用此接口自動跳轉至其他小程序。
需要用戶確認跳轉
在跳轉至其他小程序前,將統一新增彈窗,詢問是否跳轉,用戶確認後才可以跳轉其他小程序。 如果用戶按一下取消,則回檔fail cancel。
每個小程序可跳轉的其他小程序數量限制為不超過10個
開發者提交新版小程序代碼時,如使用了跳轉其他小程序功能,則需要在代碼配置中聲明將要跳轉的小程序名單,限定不超過10個,否則將無法通過審核。 該名單可在發佈新版時更新,不支持動態修改。 配置方法詳見配置。,當呼叫此接口時,所跳轉的 appId 必須在組態清單中,否則回呼fail。 fail appId "${appId}" is not in navigateToMiniProgramAppIdList
- 示例代碼:
js
wx.navigateToMiniProgram({
appId: '',
path: 'page/index/index?id=123',
extraData: {
foo: 'bar'
},
envVersion: 'develop',
success(res) {
// open success
}
})navigateBackMiniProgram
TIP
該API使用方法為: wx.navigateBackMiniProgram(Object object)
- 功能說明: 返回到上一個小程序。 只有在當前小程序是被其他小程序打開時可以調用成功。
- 參數及說明: Object object。
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| extraData | Object | {} | 否 | 需要返回給上一個小程序的數據,上一個小程序可在App.onShow中獲取到這份數據 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數(無論成功與否都執行) |
- 示例代碼:
js
wx.navigateBackMiniProgram({
extraData: {
foo: 'bar'
},
success(res) {
// back success
}
})