Skip to content

导航

Navigation 提供了一套完整的导航 API,用于管理页面栈。

push

推入新页面到栈顶。

tsx
import { push } from '@0x30/navigation-vue'

// 基础用法
push(<DetailPage />)

// 传递参数
push(<DetailPage id={1} name="test" />)

// 等待页面进入完成
await push(<DetailPage />)
tsx
import { push } from '@0x30/navigation-react'

// 基础用法
push(<DetailPage />)

// 传递参数
push(<DetailPage id={1} name="test" />)

// 等待页面进入完成
await push(<DetailPage />)

back

返回上一页。

tsx
import { back } from '@0x30/navigation-vue'

// 返回上一页
back()

// 等待返回完成
await back()
tsx
import { back } from '@0x30/navigation-react'

// 返回上一页
back()

// 等待返回完成
await back()

replace

替换当前页面。

tsx
import { replace } from '@0x30/navigation-vue'

// 替换为新页面
replace(<NewPage />)
tsx
import { replace } from '@0x30/navigation-react'

// 替换为新页面
replace(<NewPage />)

blackBoxBack

静默返回多层页面,中间页面不会触发动画和生命周期。

tsx
import { blackBoxBack } from '@0x30/navigation-vue'

// 静默返回 2 层
// 页面栈:A -> B -> C -> D
// 执行后:A -> B(C 和 D 被静默移除)
blackBoxBack(2)
tsx
import { blackBoxBack } from '@0x30/navigation-react'

// 静默返回 2 层
// 页面栈:A -> B -> C -> D
// 执行后:A -> B(C 和 D 被静默移除)
blackBoxBack(2)

适用场景:

  • 多步骤流程完成后直接返回首页
  • 跳过中间过渡页面

backToHome

返回到首页,清除中间所有页面。

tsx
import { backToHome } from '@0x30/navigation-vue'

// 返回首页
backToHome()
tsx
import { backToHome } from '@0x30/navigation-react'

// 返回首页
backToHome()

goBack

返回指定层数。

tsx
import { goBack } from '@0x30/navigation-vue'

// 返回 2 层
goBack(2)
tsx
import { goBack } from '@0x30/navigation-react'

// 返回 2 层
goBack(2)

to

导航到指定路径(URL 路径)。

tsx
import { to } from '@0x30/navigation-vue'

// 导航到指定路径
to('/user/123')
tsx
import { to } from '@0x30/navigation-react'

// 导航到指定路径
to('/user/123')

应用的根导航容器。

tsx
import { Navigator } from '@0x30/navigation-vue'

<Navigator 
  homePage={<HomePage />}
  onMounted={() => console.log('导航已挂载')}
/>

Props

属性类型说明
homePageReactNode / VNode首页组件
onMounted() => void导航挂载完成回调

Released under the MIT License.