Navigator

About 5 min

Navigator

路由容器组件,提供路由跳转能力。

权限列表

子组件

可以包含子组件。

接口

Navigator(value?: {target: string, type?: NavigationType})

创建路由组件。

  • 参数

    参数名

    参数类型

    必填

    默认值

    参数描述

    target

    string

    -

    指定跳转目标页面的路径。

    type

    NavigationType

    Push

    指定路由方式。

  • NavigationType枚举说明

    名称

    描述

    Push

    跳转到应用内的指定页面。

    Replace

    用应用内的某个页面替换当前页面,并销毁被替换的页面。

    Back

    返回上一页面或指定的页面。

属性

名称

参数

默认值

描述

active

boolean

-

当前路由组件是否处于激活状态,处于激活状态时,会生效相应的路由操作。

params

Object

undefined

跳转时要同时传递到目标页面的数据,可在目标页面使用router.getParams()获得。

示例

// Navigator Page
@Entry
@Component
struct NavigatorExample {
  @State active: boolean = false
  @State Text: string = 'news'

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start, justifyContent: FlexAlign.SpaceBetween }) {
      Navigator({ target: 'pages/container/navigator/Detail', type: NavigationType.Push }) {
        Text('Go to ' + this.Text + ' page').width('100%').textAlign(TextAlign.Center)
      }.params({ text: this.Text })

      Navigator() {
        Text('Back to previous page').width('100%').textAlign(TextAlign.Center)
      }.active(this.active)
      .onClick(() => {
        this.active = true
      })
    }.height(150).width(350).padding(35)
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// Detail Page
import router from '@system.router'

@Entry
@Component
struct DetailExample {
  @State text: string = router.getParams().text

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start, justifyContent: FlexAlign.SpaceBetween }) {
      Navigator({ target: 'pages/container/navigator/Back', type: NavigationType.Push }) {
        Text('Go to back page').width('100%').height(20)
      }

      Text('This is ' + this.text + ' page').width('100%').textAlign(TextAlign.Center)
    }
    .width('100%').height(200).padding({ left: 35, right: 35, top: 35 })
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// Back Page
@Entry
@Component
struct BackExample {
  build() {
    Column() {
      Navigator({ target: 'pages/container/navigator/Navigator', type: NavigationType.Back }) {
        Text('Return to Navigator Page').width('100%').textAlign(TextAlign.Center)
      }
    }.width('100%').height(200).padding({ left: 35, right: 35, top: 35 })
  }
}
1
2
3
4
5
6
7
8
9
10
11
12