编程式导航
编程式导航是指通过代码控制页面的跳转和后退,而不是通过用户的点击操作触发。
在小程序中,我们可以使用以下三个方法来进行编程式导航:
-
wx.switchTab(Object object)
:跳转到 tabBar 页面 -
wx.navigateTo(Object object)
:跳转到非 tabBar 页面 -
wx.navigateBack(Object object)
:后退导航,返回上一页面或多级页面
下面将对三个方法分别进行详细说明。
1. 导航到 tabBar 页面
使用 wx.switchTab(Object object)
方法可以跳转到 tabBar 页面。需要注意的是,wx.switchTab
方法只能跳转到 tabBar 页面,不能跳转到非 tabBar 页面。
以下是 wx.switchTab
方法的参数对象属性列表:
属性 | 类型 | 是否必选 | 说明 |
---|---|---|---|
url | string | 是 | 需要跳转的 tabBar 页面的路径 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数 |
下面是一个跳转到 message
页面的示例代码:
// 页面结构
<button bindtap="gotoMessage">跳转到消息页面</button>
// 通过编程式导航,跳转到 message 页面
gotoMessage() {
wx.switchTab({
url: '/pages/message/message'
})
}
2. 导航到非 tabBar 页面
使用 wx.navigateTo(Object object)
方法可以跳转到非 tabBar 页面。需要注意的是,wx.navigateTo
方法只能跳转到非 tabBar 页面,不能跳转到 tabBar 页面。
以下是 wx.navigateTo
方法的参数对象属性列表:
属性 | 类型 | 是否必选 | 说明 |
---|---|---|---|
url | string | 是 | 需要跳转的非 tabBar 页面的路径,可以带参数 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
下面是一个跳转到 info
页面的示例代码:
// 页面结构
<button bindtap="gotoInfo">跳转到info页面</button>
// 通过编程式导航,跳转到 info 页面
gotoInfo() {
wx.navigateTo({
url: '/pages/info/info'
})
}
3. 后退导航
使用 wx.navigateBack(Object object)
方法可以返回上一页面或多级页面。
以下是 wx.navigateBack
方法的参数对象可选属性列表:
属性 | 类型 | 默认值 | 是否必选 | 说明 |
---|---|---|---|---|
delta | number | 1 | 否 | 返回的页面数,如果 delta 大于现有页面数,则返回到首页 |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
下面是一个后退到上一页面的示例代码:
// 页面结构
<button bindtap="gotoBack">后退</button>
// 编程式导航,后退到上一页面
gotoBack() {
wx.navigateBack()
}
以上便是小程序中编程式导航的使用方法。在实际开发中,我们可以根据需求选择合适的方法进行页面跳转和后退。