路由

switchTab

TIP

該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": "home"
    },{
      "pagePath": "other",
      "text": "other"
    }]
  }
}

wx.switchTab({
  url: '/index'
})

reLaunch

TIP

該API使用方法為： wx.reLaunch(Object object)

• 功能說明： 關閉所有頁面，打開到應用內的某個頁面。
• 參數及說明： Object object。

内容	類型	預設值	必填	說明
url	string	-	是	需要跳轉的應用內非tabBar的頁面的路徑（代碼包路徑），路徑後可以帶參數，參數與路徑之間使用？ 分隔，參數鍵與參數值用=相連，不同參數用&分隔； 如'path？ key=value&key2=value2'
success	Function	-	否	接口調用成功的回呼函數
fail	Function	-	否	接口調用失敗的回呼函數
complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

• 示例代碼：

wx.reLaunch({
  url: 'test?id=1'
})

redirectTo

TIP

該API使用方法為： wx.redirectTo(Object object)

• 功能說明： 關閉當前頁面，跳轉到應用內的某個頁面。 但是不允許跳轉到tabbar頁面。
• 參數及說明： Object object。

内容	類型	預設值	必填	說明
url	string	-	是	需要跳轉的應用內頁面路徑（代碼包路徑），路徑後可以帶參數。 參數與路徑之間使用？ 分隔，參數鍵與參數值用=相連，不同參數用&分隔； 如'path？ key=value&key2=value2'
success	Function	-	否	接口調用成功的回呼函數
fail	Function	-	否	接口調用失敗的回呼函數
complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

• 示例代碼：

wx.redirectTo({
  url: 'test?id=1'
})

navigateTo

TIP

該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.js
Page({
  onLoad: (option){
      console.log(option.query)
    }
})

navigateBack

TIP

該API使用方法為： wx.navigateBack(Object object)

• 功能說明： 關閉當前頁面，返回上一頁面或多級頁面，可通過 getCurrentPages 獲取當前的頁面棧，决定需要返回幾層。
• 參數及說明： Object object。

内容	類型	預設值	必填	說明
data	number	1	否	返回的頁面數，如果delta大於現有頁面數，則返回到首頁
success	Function	-	否	接口調用成功的回呼函數
fail	Function	-	否	接口調用失敗的回呼函數
complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

• 示例代碼：

// Note: When calling navigateTo for navigation, the page that calls this method will be added to the stack, whereas the redirectTo method will not. See the example code below.
// This is page A
wx.navigateTo({
  url: 'B?id=1'
})

// This is page B
wx.navigateTo({
  url: 'C?id=1'
})

// Perform navigateback within page C will return to page A.
wx.navigateBack({
  delta: 2
})

EventChannel

頁面間事件通信通道

EventChannel.emit

TIP

該API使用方法為： EventChannel.emit(string eventName, any args)

• 功能說明： 觸發一個事件
• 參數及說明： string eventName， 事件名稱； any args， 事件參數。

EventChannel.off

TIP

該API使用方法為： EventChannel.off(string eventName, EventCallback fn)

• 功能說明： 取消監聽一個事件。 給出第二個參數時，只取消給出的監聽函數，否則取消所有監聽函數，使用方法為EventChannel.off（string eventName，function fn）。
• 參數及說明： string eventName， 事件名稱； function fn， 事件監聽函數； any args， 觸發事件參數。

EventChannel.on

TIP

該API使用方法為： EventChannel.on(string eventName, EventCallback fn)

• 功能說明： 持續監聽一個事件，使用方法為EventChannel.on（string eventName，function fn）。
• 參數及說明： string eventName， 事件名稱； function fn， 事件監聽函數； any args， 觸發事件參數。

EventChannel.once

TIP

該API使用方法為： EventChannel.once(string eventName, EventCallback fn)

• 功能說明： 監聽一個事件一次，觸發後失效，使用方法為EventChannel.once（string eventName，function fn）。
• 參數及說明： string eventName， 事件名稱； function fn， 事件監聽函數； any args， 觸發事件參數。