# Navigator
> **说明:**
>该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
路由容器组件,提供路由跳转能力。
## 权限列表
无
## 子组件
可以包含子组件。
## 接口
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)
}
}
```
```
// 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 })
}
}
```
```
// 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 })
}
}
```
