百度智能小程序 小程序导航

在智能小程序中，导航跳转是连接两个页面的纽带，由于框架导航实现底层原理的黑盒效应，以及页面容器的场景和类型不同，导致我们在开发小程序过程中，不能清晰的判断页面的一些表现，例如返回图标（客户端绘制的一个左箭头图标，位于顶部导航栏的最左侧，用于返回上一个小程序页面容器）与首页图标（客户端绘制的一个小房子图标，用于打开小程序 app.json 配置的首页）使用场景不明确。

通过对小程序框架进行分析，我们整理了全面的导航原理以及页面跳转后客户端的表现，希望为您的开发带来帮助。

页面跳转底层原理

智能小程序提供了 5 种路由方式，即: navigateTo、redirectTo、navigateBack、switchTab、reLaunch，除直接调用 API 的方式，还可以通过 navigator 组件 绑定属性的方式触发路由跳转。假设从 A 页面跳转到 B 页面，针对 5 种不同的跳转，通过对智能小程序分析，客户端和小程序框架配合如下：

原生小程序页面

假设我们的所有页面都在原生小程序页面跳转：

• 当首次打开的页面为非二级页面（app.json pages 配置的首项页面或者 tabBar 页面），那么此页面不会有返回按钮和首页图标，此时如果通过跳转下一个新的页面（客户端新开一个容器，且不为 tabBar 页面），则会在顶部导航栏左侧增加一个返回按钮；
• 当首次打开的页面为二级页面（非 app.json pages 配置的首项页面或者非 tabBar 页面），那么此页面就会出现首页图标，此时如果通过导航跳转下一个新的页面（客户端新开一个容器，且不为 tabBar 页面），则会在首页图标左侧增加一个返回按钮；
• 在跳转多次后，当我们操作返回到上一个页面时，客户端会将当前页面容器关掉，将待返回到的页面容器从后台切到前台展示，这一过程客户端顶部导航栏不会有刷新操作。如果我们不想使用客户端的原生顶部导航栏，转而想进行导航栏自定义，那么可以在 app.json 或者对应 page.json 增加配置（navigationStyle: custom），此时客户端就会隐藏掉原生顶部导航栏，开发者就可以通过标签样式进行定制化导航栏（未包括状态栏）。

web-view 组件撑起的 h5 页面

使用说明

智能小程序官方并不推荐使用 web-view 组件承载 h5 页面。因为这和原生小程序页面相比性能有极大的劣势，并不能给我们的用户带来更好的体验。但是，在初期阶段确实存在将 h5 页面先迁移到小程序中的诉求。

在 web-view 组件承载 h5 页面中，如果想要跳转到一个新的小程序页面（即客户端新开一个容器），需要配合 jssdk 进行操作。

场景举例

当需要从 h5 无缝转接到小程序，首先想到的就是小程序内放置一个web-view组件来链接之前的 h5 页面，一行代码就完成了迁移到小程序的难题。实际情况如下图：

小程序，页面左上角没有返回按钮，只能不停的往下点，无法返回。

问题原因：

使用 web-view 组件的 h5 中跳转到 h5 的下一个页面，客户端并没有打开一个新的小程序页面，而是在当前 web-view 组件加载了新的网页，这样导致客户端的页面栈没有增加新的小程序页面，导航栏的返回按钮没有出现，导航栏上还是原来的按钮。

正常情况下，小程序直接打开一个非首页小程序页面，会出现首页图标，如未点击首页或者右上角“更多”里面的回首页或者首页图标，在跳转到新的小程序页面的时候，首页图标将会一直存在。

解决方案：

通过跳转新的小程序页面，比如在将要加载的 h5 也放个 web-view 组件，触发新的小程序页面加载，下一个页面的左上角是会有返回按钮，体验上和原生一致。效果图：

那么问题来了，怎么把点击的链接传到第二个页面呢？我们可以在 web-view 组件 页面使用 jssdk 中 h5 页面跳转到小程序页面的方法 小程序.webView.navigateTo，然后再携带一个 url 参数：

代码示例

navigate(url) {
    swan.webView.navigateTo({url: '../webview/webview?weburl=' + url});
}

接着在小程序另外一个新的 web-view 组件页面中：代码示例

Page({
    data: {
    url:''
    },
    // 监听页面加载，获取H5页面传递过来的weburl
    onLoad: function (options) {
    this.setData({
      url: options.weburl
    });
  }
});

并赋值给 webview.小程序 中的 src 属性：

// pages/webview/webview.swan
<web-view src="{{url}}"></web-view>

不推荐使用的解决方案：

• 客户端上可以通过侧滑返回到 web-view 组件的上一个网页内容。缺点：一方面没有原生导航栈返回的动画效果，另一个方面作为用户来说，这个操作隐藏的比较深，难以发现。
• 在每个 h5 页面都加上一个带返回按钮的导航栏。缺点：因为小程序页面的头部已经有个导航栏了，再加一个的话就显得非常的不协调，影响用户体验。
• 使用自定义导航栏样式，新增导航栏，在 app.json 或者对应 page.json 增加配置（navigationStyle: custom），缺点：web-view 组件页面不支持自定义导航栏样式。

web-view 组件的返回

点击返回按钮：

• 如果当前是在使用 web-view 组件的小程序页面，web-view 组件首先回退展示的前一个 h5 内容，类似浏览器的网页返回。
• 如果 web-view 组件没有内容可以返回，就触发小程序页面栈的返回效果。
• 如果是当前小程序页面栈首页，再返回，会回到上一个小程序或者非小程序 NA 页面。举例：小程序页面栈内部导航流程图：

小程序间跳转

当我们从一个小程序打开另一个小程序，单个小程序间页面跳转参见原生小程序页面、web-view 组件撑起的 h5 页面，目前百度 APP 客户端最多支持打开 6 个小程序，超出之后会按打开顺序依次替换掉最先打开的小程序，当用户主动进行小程序切换（点击右上角的关闭按钮，将当前小程序送入后台，或者在 android 多任务管理中直接切换到某一个小程序页面）时，会触发每个小程序的部分生命周期，并不会刷新导航栏。因此可以在跳转到某个小程序后，继续使用之前的导航跳转方法。小程序间的导航流程图：Tips：

• 使用自定义导航栏时，请先参考 原生顶部导航栏。通常情况下，为保证良好的用户体验，可能需要自己实现默认导航中的「返回/回首页」等功能，此时可以借助 getCurrentPages 来判断当前页面栈的深度，从而决定是否应该展示「返回/回首页」按钮。