Skip to content
Mr.HopeMr.Hope
主页
  • 小程序
    • 小程序教程

      • 小程序指南
        • 代码构成
          • 宿主环境
            • 配置

              • 配置
                • 全局配置文档
                  • 页面配置
                    • 小程序内索引
                    • 框架

                      • 框架
                        • 场景值
                          • 小程序的运行环境
                            • 小程序运行机制
                              • 小程序更新机制
                              • 逻辑层

                                • 逻辑层
                                  • 生命周期 <Badge text="不需要立即掌握" />
                                    • 页面路由
                                      • 注册
                                        • App
                                          • Page
                                            • 小程序运行机制
                                              • 模块化
                                                • API

                                                  • API <Badge text="重要" type="error" />
                                                    • 路由 API
                                                      • wx.navigateTo(Object object)
                                                        • navigateTo 参数
                                                          • navigateToObject.success
                                                          • wx.navigateBack(Object object)
                                                            • navigateBack 参数
                                                            • wx.redirectTo(Object object)
                                                              • redirectTo 参数
                                                              • wx.switchTab(Object object)
                                                                • switchTab 参数
                                                                • wx.reLaunch(Object object)
                                                                  • reLaunch 参数
                                                                • 数据缓存 API
                                                                  • 页面交互 API
                                                                    • 网络 API
                                                                      • 系统相关 API
                                                                    • 视图层

                                                                      • 视图层 View
                                                                        • WXSS
                                                                          • 事件
                                                                            • 基础组件
                                                                              • 动画
                                                                                • WXS
                                                                                  • WXS 事件
                                                                                    • 简易双向绑定
                                                                                      • 获取界面上的节点信息
                                                                                        • 初始渲染缓存
                                                                                        • 能力

                                                                                          • 小程序能力
                                                                                            • 网络
                                                                                              • 存储
                                                                                                • 文件系统
                                                                                                  • 调试
                                                                                                • 开发者工具

                                                                                                  • 工具使用
                                                                                                    • 界面
                                                                                                      • 调试
                                                                                                        • npm 支持
                                                                                                          • 体验评分
                                                                                                          • 小程序框架

                                                                                                            • 小程序框架说明
                                                                                                              • 小程序简易开发指南
                                                                                                                • 小程序页面参数表
                                                                                                                  • Page 插件
                                                                                                                    • YAML 文件案例
                                                                                                                    • 小程序分享

                                                                                                                      路由 API

                                                                                                                      Mr.Hope2020年11月8日
                                                                                                                      • 小程序
                                                                                                                      大约 4 分钟

                                                                                                                      此页内容
                                                                                                                      • wx.navigateTo(Object object)
                                                                                                                        • navigateTo 参数
                                                                                                                        • navigateToObject.success
                                                                                                                      • wx.navigateBack(Object object)
                                                                                                                        • navigateBack 参数
                                                                                                                      • wx.redirectTo(Object object)
                                                                                                                        • redirectTo 参数
                                                                                                                      • wx.switchTab(Object object)
                                                                                                                        • switchTab 参数
                                                                                                                      • wx.reLaunch(Object object)
                                                                                                                        • reLaunch 参数

                                                                                                                      # 路由 API

                                                                                                                      本页面介绍的一系列 API 都是和小程序路由(导航)相关的 API。

                                                                                                                      可以通过这些 API,自定义小程序的页面导航逻辑。

                                                                                                                      概要

                                                                                                                      最常用的两个:

                                                                                                                      • wx.navigateTo: 导航到一个新页面
                                                                                                                      • wx.navigateBack: 返回上一层(上 n 层)页面

                                                                                                                      不太常用的三个:

                                                                                                                      • wx.redirectTo: 将当前页面重定向到一个新的页面
                                                                                                                      • wx.switchTab: 到转到 Tabbar 的页面并关闭其他页面
                                                                                                                      • wx.reLaunch: 关闭小程序所有页面,并打开指定页面

                                                                                                                      # wx.navigateTo(Object object)

                                                                                                                      保留当前页面,跳转到应用内的某个页面。但是不能跳到 tabbar 页面。使用 wx.navigateBack 可以返回到原页面。小程序中页面栈最多十层。

                                                                                                                      # navigateTo 参数

                                                                                                                      Object object

                                                                                                                      属性类型必填说明
                                                                                                                      urlstring是需要跳转的应用内非 tabBar 的页面的路径, 路径后可以带参数。参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔;如 'path?key=value&key2=value2'
                                                                                                                      eventsObject否页面间通信接口,用于监听被打开页面发送到当前页面的数据。
                                                                                                                      基础库 2.7.3 开始支持
                                                                                                                      successfunction否接口调用成功的回调函数
                                                                                                                      failfunction否接口调用失败的回调函数
                                                                                                                      completefunction否接口调用结束的回调函数(调用成功、失败都会执行)

                                                                                                                      # navigateToObject.success 初学无需掌握

                                                                                                                      参数

                                                                                                                      Object res

                                                                                                                      属性类型说明
                                                                                                                      eventChannelEventChannel和被打开页面进行通信

                                                                                                                      示例代码

                                                                                                                      wx.navigateTo({
                                                                                                                        url: 'test?id=1',
                                                                                                                        events: {
                                                                                                                          // 为指定事件添加一个监听器,获取被打开页面传送到当前页面的数据
                                                                                                                          acceptDataFromOpenedPage(data) {
                                                                                                                            console.log(data)
                                                                                                                          },
                                                                                                                          someEvent(data) {
                                                                                                                            console.log(data)
                                                                                                                          }
                                                                                                                          ...
                                                                                                                        },
                                                                                                                        success: res => {
                                                                                                                          // 通过 eventChannel 向被打开页面传送数据
                                                                                                                          res.eventChannel.emit('acceptDataFromOpenerPage', { data: 'test' });
                                                                                                                        }
                                                                                                                      });
                                                                                                                      
                                                                                                                      //test.js
                                                                                                                      Page({
                                                                                                                        onLoad(option) {
                                                                                                                          console.log(option.query);
                                                                                                                          const eventChannel = this.getOpenerEventChannel();
                                                                                                                      
                                                                                                                          eventChannel.emit("acceptDataFromOpenedPage", { data: "test" });
                                                                                                                          eventChannel.emit("someEvent", { data: "test" });
                                                                                                                          // 监听a cceptDataFromOpenerPage 事件,获取上一页面通过 eventChannel 传送到当前页面的数据
                                                                                                                          eventChannel.on("acceptDataFromOpenerPage", (data) => {
                                                                                                                            console.log(data);
                                                                                                                          });
                                                                                                                        },
                                                                                                                      });
                                                                                                                      

                                                                                                                      # wx.navigateBack(Object object)

                                                                                                                      关闭当前页面,返回上一页面或多级页面。可通过 getCurrentPages 获取当前的页面栈,决定需要返回几层。

                                                                                                                      # navigateBack 参数

                                                                                                                      Object object

                                                                                                                      属性类型默认值必填说明
                                                                                                                      deltanumber1否返回的页面数,如果 delta 大于现有页面数,则返回到首页。
                                                                                                                      successfunction否接口调用成功的回调函数
                                                                                                                      failfunction否接口调用失败的回调函数
                                                                                                                      completefunction否接口调用结束的回调函数(调用成功、失败都会执行)

                                                                                                                      示例代码

                                                                                                                      // 注意: 调用 navigateTo 跳转时,调用该方法的页面会被加入堆栈,而 redirectTo 方法则不会。见下方示例代码
                                                                                                                      
                                                                                                                      // 此处是A页面
                                                                                                                      wx.navigateTo({ url: "B?id=1" });
                                                                                                                      
                                                                                                                      // 此处是B页面
                                                                                                                      wx.navigateTo({ url: "C?id=1" });
                                                                                                                      
                                                                                                                      // 在C页面内 navigateBack,将返回A页面
                                                                                                                      wx.navigateBack({ delta: 2 });
                                                                                                                      

                                                                                                                      # wx.redirectTo(Object object)

                                                                                                                      关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面。

                                                                                                                      # redirectTo 参数

                                                                                                                      Object object

                                                                                                                      属性类型必填说明
                                                                                                                      urlstring是需要跳转的应用内非 tabBar 的页面的路径, 路径后可以带参数。参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔;如 'path?key=value&key2=value2'
                                                                                                                      successfunction否接口调用成功的回调函数
                                                                                                                      failfunction否接口调用失败的回调函数
                                                                                                                      completefunction否接口调用结束的回调函数(调用成功、失败都会执行)

                                                                                                                      示例代码

                                                                                                                      wx.redirectTo({
                                                                                                                        url: "test?id=1",
                                                                                                                      });
                                                                                                                      

                                                                                                                      # wx.switchTab(Object object)

                                                                                                                      跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面

                                                                                                                      # switchTab 参数

                                                                                                                      Object object

                                                                                                                      属性类型默认值必填说明
                                                                                                                      urlstring是需要跳转的 tabBar 页面的路径(需在 app.json 的 tabBar 字段定义的页面),路径后不能带参数。
                                                                                                                      successfunction否接口调用成功的回调函数
                                                                                                                      failfunction否接口调用失败的回调函数
                                                                                                                      completefunction否接口调用结束的回调函数(调用成功、失败都会执行)

                                                                                                                      示例代码

                                                                                                                      {
                                                                                                                        "tabBar": {
                                                                                                                          "list": [
                                                                                                                            {
                                                                                                                              "pagePath": "index",
                                                                                                                              "text": "首页"
                                                                                                                            },
                                                                                                                            {
                                                                                                                              "pagePath": "other",
                                                                                                                              "text": "其他"
                                                                                                                            }
                                                                                                                          ]
                                                                                                                        }
                                                                                                                      }
                                                                                                                      
                                                                                                                      wx.switchTab({
                                                                                                                        url: "/index",
                                                                                                                      });
                                                                                                                      

                                                                                                                      # wx.reLaunch(Object object)

                                                                                                                      关闭所有页面,打开到应用内的某个页面

                                                                                                                      # reLaunch 参数

                                                                                                                      Object object

                                                                                                                      属性类型必填说明
                                                                                                                      urlstring是需要跳转的应用内页面路径,路径后可以带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔;如 'path?key=value&key2=value2'
                                                                                                                      successfunction否接口调用成功的回调函数
                                                                                                                      failfunction否接口调用失败的回调函数
                                                                                                                      completefunction否接口调用结束的回调函数(调用成功、失败都会执行)

                                                                                                                      示例代码

                                                                                                                      wx.reLaunch({
                                                                                                                        url: "test?id=1",
                                                                                                                      });
                                                                                                                      
                                                                                                                      // test
                                                                                                                      Page({
                                                                                                                        onLoad(option) {
                                                                                                                          console.log(option.query);
                                                                                                                        },
                                                                                                                      });
                                                                                                                      
                                                                                                                      编辑此页open in new window
                                                                                                                      上次编辑于: 2021/3/21 10:12:13
                                                                                                                      贡献者: Mr.Hope
                                                                                                                      上一页
                                                                                                                      API <Badge text="重要" type="error" />
                                                                                                                      下一页
                                                                                                                      数据缓存 API

                                                                                                                      预览:

                                                                                                                      0  字
                                                                                                                      评论
                                                                                                                      Powered by Waline v2.5.1
                                                                                                                      Copyright © 2019-present Mr.Hope