Navigation组件的功能和使用方法

更新：2024-11-15 09:46:23编辑：游戏资讯归类：攻略

Navigation组件适用于模块内和跨模块的路由切换。通过组件级路由能力实现更加自然流畅的转场体验，并提供多种标题栏样式来呈现更好的标题和内容联动效果。在一次开发、多端部署的场景下，Navigation组件能够自动适配窗口显示大小，在窗口较大的场景下自动切换分栏展示效果。

根页面设置

在Entry的入口处Index.ets使用Navigation当作根页面，这里会面临一个问题，怎么从启动页跳转到首页，并关闭启动页，使用首页一直留在页面栈中，不允许销毁。在使用Navigation时，由于默认带有TitleBar和Toolbar，样式不易自定义，我们可以直接隐藏它们。实际需要的话，可以自行实现。由于默认是Auto模式，以便于适配大屏设备，若我们在大屏设备上不使用分栏效果，可以强制设置单页面模式。

@Entry
@ComponentV2
struct Index {
  nav: NavPathStack = new NavPathStack()

  build() {
    Navigation(this.nav)
    .mode(NavigationMode.Stack)
    .hideToolBar(true)
    .hideTitleBar(true)
    .height('100%')
    .width('100%')
  }
}

系统路由表配置

接下来我们需要配置系统路由表。在resources/base/profile目录下新建一个json文件，例如router_map.json，并在里面配置相关的路由页面，例如我们配置一个弹窗页面和一个登录页面。

{
  "routerMap": [
    {
      "name": "dialog",
      "pageSourceFile": "src/main/ets/pages/dialog/DialogPage.ets",
      "buildFunction": "dialogBuilder"
    },
    {
      "name": "login",
      "pageSourceFile": "src/main/ets/pages/login/LoginPage.ets",
      "buildFunction": "loginBuilder"
    }
  ]
}

在routerMap里面配置具体的页面，name为页面名称，使用push打开新页面时，传的name名称就是这里定义的。pageSourceFile为页面源文件，buildFunction为页面入口builder，通过源文件找到这个入口builder。在module.json5文件中有一个routerMap字段，值为我们前面定义的router_map.json

实现子页面

路由表定义好后，我们需要实现具体的页面，这里分别实现一个弹窗页面和标准页面。弹窗示例如下，页面模式需要设置为NavDestinationMode.DIALOG。

@Builder
function dialogBuilder() {
  DialogPage()
}
@ComponentV2
export struct DialogPage {
  build() {
    NavDestination() {
      Stack() {
        Column() {
          Text('弹窗标题')
          Text('弹窗内容')

          Row() {
            Text('取消').layoutWeight(1)
            Text('确定').layoutWeight(1)
          }
        }
        .width('80%')
        .borderRadius(16)
        .backgroundColor($r('app.color.start_window_background'))
      }
      .width('100%')
      .height('100%')
    }
    .hideTitleBar(true)
    .mode(NavDestinationMode.DIALOG)
  }
}

标准登录页面如下，默认为标准模式，mode可以省略不设置。

@Builder
function loginBuilder() {
  LoginPage()
}
@ComponentV2
export struct LoginPage {
  build() {
    NavDestination() {
      Column() {
        Text('账号')
        Text('密码')
        Text('登录')
      }
    }
    .width('100%')
    .height('100%')
    .hideTitleBar(true)
  }
}

页面跳转操作

打开新页面

使用NavPathStack的pushPath或pushPathByName可以打开一个新页面，例如打开登录页面则是navPathStack.pushPathByName('login', undefined)，显示一个弹窗则是navPathStack.pushPathByName('dialog', undefined)。可以发现使用Navigation来实现弹窗还是非常简单的，而且可以全局显示，不依赖于具体页面以及Context，而且弹窗还有显示隐藏等回调。