Skip to content

跳轉

exitMiniProgram

TIP

該API使用方法為: wx.exitMiniProgram(Object object)

  • 功能說明: 退出當前小程序。 必須有按一下行為才能調用成功。
  • 參數及說明: Object object。
内容類型預設值必填說明
successFunction-接口調用成功的回呼函數
failFunction-接口調用失敗的回呼函數
completeFunction-接口調用結束的回呼函數(無論成功與否都執行)

TIP

該API使用方法為: wx.navigateToMiniProgram(Object object)

  • 功能說明: 打開另一個小程序
  • 參數及說明: Object object。
内容類型預設值必填說明
appIdstring-要打開的小程序appId
pathstring-打開的頁面路徑,如果為空則打開首頁, path中? 後面的部分會成為query,在小程序的 App.onLaunch,App.onShow Page.onLoad 的回呼函數或 wx.getLaunchOptionsSync中可以獲取到query數據
extraDataobject-需要傳遞給目標小程序的數據,目標小程序可在App.onLaunch,App.onShow中獲取到這份數據
envVersionstringrelease要打開的小程序版本。 僅在當前小程序為開發版或體驗版時此參數有效。 如果當前小程序是正式版,則打開的小程序必定是正式版,其合法值如下:
1.develop: 開發版
2trial: 體驗版
3.release: 正式版
successFunction-接口調用成功的回呼函數
failFunction-接口調用失敗的回呼函數
completeFunction-接口調用結束的回呼函數(無論成功與否都執行)

使用限制。

需要用戶觸發跳轉

若用戶未按一下小程序頁面任意位置,則開發者將無法調用此接口自動跳轉至其他小程序。

需要用戶確認跳轉

在跳轉至其他小程序前,將統一新增彈窗,詢問是否跳轉,用戶確認後才可以跳轉其他小程序。 如果用戶按一下取消,則回檔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
  }
})

TIP

該API使用方法為: wx.navigateBackMiniProgram(Object object)

  • 功能說明: 返回到上一個小程序。 只有在當前小程序是被其他小程序打開時可以調用成功。
  • 參數及說明: Object object。
内容類型預設值必填說明
extraDataObject{}需要返回給上一個小程序的數據,上一個小程序可在App.onShow中獲取到這份數據
successFunction-接口調用成功的回呼函數
failFunction-接口調用失敗的回呼函數
completeFunction-接口調用結束的回呼函數(無論成功與否都執行)
  • 示例代碼:
js
wx.navigateBackMiniProgram({
  extraData: {
    foo: 'bar'
  },
  success(res) {
    // back success
  }
})