React / 系统课时
执行程序化导航
执行程序化导航
当跳转必须发生在校验、提交或条件判断之后,仅靠 Link 不够。本课将使用 useRouter 完成前进、替换、返回和刷新,并区分这些方法对历史记录与服务端组件的影响。
学习目标
- 在客户端组件中正确调用
useRouter - 区分
push、replace、back与refresh - 避免把不可信输入直接作为跳转地址
什么时候使用 useRouter
普通页面入口仍应优先使用 Link,因为链接具有清晰的语义,也能自动参与预取。程序化导航适合“操作完成后再跳转”,例如登录成功进入控制台、保存表单后打开详情页,或根据权限结果返回上一页。
useRouter 只能在客户端组件中调用,因此文件需要包含 'use client'。在 App Router 中应从 next/navigation 导入,而不是从旧的 next/router 导入。
完成跳转、返回与刷新
下面的页面同时包含服务端生成时间和客户端计数器。点击“刷新当前路由”会重新请求服务端组件结果,但不会主动清空未受影响的客户端状态。
// 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>
}预期结果:
点击“进入控制台”后访问 /dashboard。
点击“前往登录页并替换当前记录”后访问 /login,浏览器返回时跳过演示页。
点击“刷新当前路由”后服务端生成时间更新,客户端计数继续保留。理解各个导航方法
router.push(url) 新增一条历史记录,适合用户主动进入下一页。router.replace(url) 替换当前记录,适合登录回调、中间页或不应再次返回的步骤。router.back() 和 router.forward() 分别使用浏览器已有的前后历史记录。
router.refresh() 会重新请求当前路由并合并新的服务端组件结果。它不是“清空所有缓存”的快捷键:如果数据仍命中持久化缓存,刷新后可能看到相同内容。需要让已缓存数据失效时,应在服务端变更逻辑中使用路径或标签重新验证。
router.prefetch(url) 可以手动预热高概率访问的路由,但不应对所有地址无差别调用,否则会增加网络和服务端压力。
安全与交互边界
传给 push 或 replace 的地址必须来自可信常量,或经过严格白名单校验。不要直接使用查询参数拼出任意 URL;恶意的 javascript: 地址可能在页面上下文中执行。
表单提交时还要防止重复点击。导航通常应发生在服务端确认操作成功之后,而不是按钮按下后立即执行。失败时保留当前页面并显示可恢复信息,用户才能修改输入或重试。