从微信小程序到鸿蒙js开发【11】——页面路由

在项目中,页面之间的路由跳转是十分普遍的。鸿蒙JS开发提供了四种页面跳转的方式(轻量级智能穿戴仅支持replace()),之前的帖子中也有涉及到一些,本文将详解这四个API并与微信小程序中类似的页面跳转方式做比较。

鸿蒙页面路由需导入router模块。import router from '@system.router';

1、router.push()&wx.navigateTo()

这两个方法都是压栈式跳转,即将跳转到的目标页面“压”在源页面上,源页面不销毁,按返回键即可返回源页面。

router.push()有两个参数,uri指定页面路径,params指定跳转携带参数。在目标页面data中只要有与params中即可接收数据,无需写额外一行代码。

从微信小程序到鸿蒙js开发【11】——页面路由

第一页 "push 下一页"按钮点击事件:

    pushNext() {
        router.push({
            uri: "pages/two/two",
            params: {
                method: "push"
            }
        })
    },

从微信小程序到鸿蒙js开发【11】——页面路由

    data: {
        method: "",
        count: 0
    },
    onShow() {
        this.count = router.getLength();
    },

router.getLength()可获取页面栈中页面数量,鸿蒙页面栈支持最大数值是32。

此时点击设备的返回按钮,即可返回第一页。

第二页 "push 下一页"按钮点击事件:

    pushNext() {
        router.push({
            uri: "pages/three/three",
            params: {
                data: {
                    name: "HarmonyOS",
                    type: "phone",
                    method: "push"
                }
            }
        })
    },

带复杂参数跳转,也是完全支持的。

从微信小程序到鸿蒙js开发【11】——页面路由

微信小程序的wx.navigateTo()方法效果一致,微信小程序中页面跳转的参数在url中携带,和统一资源定位符的规则一致。且支持success,fail,complete回调函数,也支持双向事件的触发。

从微信小程序到鸿蒙js开发【11】——页面路由

第一页 "navigateTo 下一页"点击事件:

  naviNext() {
    wx.navigateTo({
      url: '../two/two?method=navigateTo',
      success: res => {
        console.log(res)
      }
    })
  },

从微信小程序到鸿蒙js开发【11】——页面路由

第二页需在onLoad()中手动接收参数,参数被传递到options对象中。

  onLoad: function (options) {
    this.setData({
      method: options.method
    })
  },

如需携带复杂参数,只能通过events参数传递,且只有navigateTo()支持该参数。微信小程序支持页面栈最大页面数为10,该方法不支持跳转到app.json中配置的tabBar页面。

2、router.replace()&wx.redirectTo()

销毁当前页面并跳转页面,源页面在页面栈中被清除。

router.replace()参数和router.push()一致,这里主要看页面栈的页面数。

第一页"replace 下一页"点击事件:

    replaceNext() {
        router.replace({
            uri: "pages/two/two",
            params: {
                method: "replace"
            }
        })
    }

第二页"replace 下一页"点击事件:

    replaceNext() {
        router.replace({
            uri: "pages/three/three",
            params: {
                data: {
                    name: "HarmonyOS",
                    type: "phone",
                    method: "replace"
                }
            }
        })
    }

连续点击replace到第三页,页面栈中页面数始终为1。

从微信小程序到鸿蒙js开发【11】——页面路由

从微信小程序到鸿蒙js开发【11】——页面路由

此时若点击设备返回键,则是退出APP的效果。

wx.redirectTo()效果类似,左上角返回按钮变为"home"按钮。微信小程序的首页是不会被销毁的,从redirectTo转到的页面点击"home"按钮也可以返回首页。

  rediNext() {
    wx.redirectTo({
      url: '../two/two?method=redirectTo',
      success: res => {
        console.log(res)
      }
    })
  },

从微信小程序到鸿蒙js开发【11】——页面路由

3、router.back()&wx.navigateBack()

返回上一页的方法,鸿蒙支持传页面path指定返回的页面路径。

从微信小程序到鸿蒙js开发【11】——页面路由

第三页"上一页、回首页"点击事件:

    back1() {
        router.back();
    },
    back2() {
        router.back({
            path: "pages/index/index"
        })
    },

back()方法会将页面栈中返回目标页面之上的页面全部清除。如页面栈中只有1个页面,back()方法会将APP退出。

微信小程序wx.navigateBack()方法可通过delta参数指定返回几层页面,如果 delta 大于现有页面数,则返回到首页。

从微信小程序到鸿蒙js开发【11】——页面路由

  naviBack(){
    wx.navigateBack({
      success: res => {
        console.log(res);
      }
    })
  },

  naviIndex(){
    wx.navigateBack({
      delta: 10,
      success: res => {
        console.log(res);
      }
    })
  },

如果页面栈中只有1个页面,此方法将无法触发并进入fail回调。但仍可点击小程序左上角"home"按钮返回首页。

4、router.clear()&wx.reLaunch()

router.clear()是清空页面栈中其余页面的方法,仅保留当前页面。

从微信小程序到鸿蒙js开发【11】——页面路由

wx.reLaunch()则可以实现清除所有页面,并转到特定页面的方法。小程序首页仍可以通过点击"home"按钮返回。

  relaNext() {
    wx.reLaunch({
      url: '../three/three?method=reLaunch',
      success: res => {
        console.log(res)
      }
    })
  },

从微信小程序到鸿蒙js开发【11】——页面路由

5、项目实践

欢迎页面跳转到首页,使用replace()。

分类->二级分类->商品列表->商品,使用push()。

从微信小程序到鸿蒙js开发【11】——页面路由

商品详情->首页,使用replace()并clear()掉多余页面。

从微信小程序到鸿蒙js开发【11】——页面路由

作者:Chris.
想了解更多内容,请访问: 51CTO和华为官方战略合作共建的鸿蒙技术社区https://harmonyos.51cto.com
posted @ 2021-02-22 10:58  HarmonyOS技术社区  阅读(473)  评论(0编辑  收藏  举报