React / 系统课时

执行程序化导航

执行程序化导航

当跳转必须发生在校验、提交或条件判断之后,仅靠 Link 不够。本课将使用 useRouter 完成前进、替换、返回和刷新,并区分这些方法对历史记录与服务端组件的影响。

学习目标

  • 在客户端组件中正确调用 useRouter
  • 区分 push、replace、back 与 refresh
  • 避免把不可信输入直接作为跳转地址

什么时候使用 useRouter

普通页面入口仍应优先使用 Link,因为链接具有清晰的语义,也能自动参与预取。程序化导航适合“操作完成后再跳转”,例如登录成功进入控制台、保存表单后打开详情页,或根据权限结果返回上一页。

useRouter 只能在客户端组件中调用,因此文件需要包含 'use client'。在 App Router 中应从 next/navigation 导入,而不是从旧的 next/router 导入。

完成跳转、返回与刷新

下面的页面同时包含服务端生成时间和客户端计数器。点击“刷新当前路由”会重新请求服务端组件结果,但不会主动清空未受影响的客户端状态。

tsx
// app/navigation-demo/NavigationActions.tsx
'use client'

import { useRouter } from 'next/navigation'
import { useState } from 'react'

export default function NavigationActions() {
  const router = useRouter()
  const [clicks, setClicks] = useState(0)

  function refreshRoute() {
    setClicks((value) => value + 1)
    router.refresh()
  }

  return (
    <section>
      <p>客户端计数:{clicks}</p>
      <button onClick={() => router.push('/dashboard')}>
        进入控制台
      </button>
      <button onClick={() => router.replace('/login')}>
        前往登录页并替换当前记录
      </button>
      <button onClick={() => router.back()}>
        返回上一页
      </button>
      <button onClick={refreshRoute}>
        刷新当前路由
      </button>
    </section>
  )
}

// app/navigation-demo/page.tsx
import NavigationActions from './NavigationActions'

export const dynamic = 'force-dynamic'

export default function NavigationDemoPage() {
  return (
    <main>
      <h1>程序化导航演示</h1>
      <p>服务端生成时间:{new Date().toISOString()}</p>
      <NavigationActions />
    </main>
  )
}

// app/dashboard/page.tsx
export default function DashboardPage() {
  return <h1>控制台</h1>
}

// app/login/page.tsx
export default function LoginPage() {
  return <h1>登录页</h1>
}

预期结果:

text
点击“进入控制台”后访问 /dashboard。
点击“前往登录页并替换当前记录”后访问 /login,浏览器返回时跳过演示页。
点击“刷新当前路由”后服务端生成时间更新,客户端计数继续保留。

理解各个导航方法

router.push(url) 新增一条历史记录,适合用户主动进入下一页。router.replace(url) 替换当前记录,适合登录回调、中间页或不应再次返回的步骤。router.back() 和 router.forward() 分别使用浏览器已有的前后历史记录。

router.refresh() 会重新请求当前路由并合并新的服务端组件结果。它不是“清空所有缓存”的快捷键:如果数据仍命中持久化缓存,刷新后可能看到相同内容。需要让已缓存数据失效时,应在服务端变更逻辑中使用路径或标签重新验证。

router.prefetch(url) 可以手动预热高概率访问的路由,但不应对所有地址无差别调用,否则会增加网络和服务端压力。

安全与交互边界

传给 push 或 replace 的地址必须来自可信常量,或经过严格白名单校验。不要直接使用查询参数拼出任意 URL;恶意的 javascript: 地址可能在页面上下文中执行。

表单提交时还要防止重复点击。导航通常应发生在服务端确认操作成功之后,而不是按钮按下后立即执行。失败时保留当前页面并显示可恢复信息,用户才能修改输入或重试。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行程序化导航

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通