NNext.js 中文网 GitHub

链接和导航

了解内置导航优化的工作原理,包括预取、预渲染和客户端导航,以及如何针对动态路由和慢速网络优化导航。

在 Next.js 中,路由默认在服务端渲染。这通常意味着客户端必须等待服务端响应才能显示新路由。Next.js 内置了预取、流式传输和客户端过渡,确保导航保持快速且响应灵敏。

本指南解释 Next.js 中的导航工作原理,以及如何针对动态路由和慢速网络进行优化。

导航的工作原理#

要理解 Next.js 中的导航工作原理,熟悉以下概念会有所帮助:

服务端渲染#

在 Next.js 中,布局和页面默认是 React Server Components。在初次和后续导航时,Server Component Payload 会在服务端生成,然后再发送到客户端。

根据发生的时机,服务端渲染分为两种类型:

  • 预渲染发生在构建时或重新验证期间,结果会被缓存。
  • 动态渲染在请求时响应客户端请求而发生。

服务端渲染的权衡之处在于,客户端必须等待服务端响应才能显示新路由。Next.js 通过预取用户可能访问的路由以及执行客户端过渡来解决这一延迟。

小知识:初次访问时也会生成 HTML。

预取#

预取是指在用户导航到某个路由之前,在后台加载该路由的过程。这使应用程序中路由之间的导航感觉是即时的,因为当用户点击链接时,渲染下一个路由所需的数据已在客户端就绪。

当使用 <Link> 组件链接的路由进入用户视口时,Next.js 会自动预取这些路由。

app/layout.tsx
import Link from 'next/link'

export default function Layout({ children }: { children: React.ReactNode }) {
  return (
    <html>
      <body>
        <nav>
          
          <Link href="/blog">Blog</Link>
          
          <a href="/contact">Contact</a>
        </nav>
        {children}
      </body>
    </html>
  )
}
app/layout.js
import Link from 'next/link'

export default function Layout({ children }) {
  return (
    <html>
      <body>
        <nav>
          
          <Link href="/blog">Blog</Link>
          
          <a href="/contact">Contact</a>
        </nav>
        {children}
      </body>
    </html>
  )
}

预取路由的程度取决于它是静态还是动态:

  • 静态路由:预取整个路由。
  • 动态路由:跳过预取,或者如果存在 loading.tsx,则部分预取该路由。

通过跳过或部分预取动态路由,Next.js 避免了在服务端为用户可能永远不会访问的路由做不必要的工作。然而,在导航前等待服务端响应可能会让用户觉得应用没有响应。

小知识:有关完整行为,请参阅预取指南,包括如何按链接控制预取,以及采用部分预取(Partial Prefetching)时的变化。要在链接的预取中包含依赖 URL 的内容,请参阅优化预取。

要改善到动态路由的导航体验,可以使用流式传输。

流式传输#

流式传输允许服务端在动态路由的各部分就绪后立即将其发送到客户端,而不必等待整个路由渲染完成。这意味着用户能更快看到内容,即使页面的某些部分仍在加载。有关流式传输在 Next.js 中工作原理的深入介绍,请参阅流式传输指南。

对于动态路由,这意味着它们可以被部分预取。也就是说,共享布局和加载骨架屏可以提前请求。

要使用流式传输,请在路由文件夹中创建一个 loading.tsx:

app/dashboard/loading.tsx
export default function Loading() {
  // 添加在路由加载时显示的后备 UI。
  return <LoadingSkeleton />
}
app/dashboard/loading.js
export default function Loading() {
  // 添加在路由加载时显示的后备 UI。
  return <LoadingSkeleton />
}

在幕后,Next.js 会自动将 page.tsx 的内容包裹在 <Suspense> 边界中。路由加载时会显示预取的后备 UI,并在就绪后替换为实际内容。

小知识:你还可以使用 <Suspense> 为嵌套组件创建加载 UI。

loading.tsx 的好处:

  • 即时导航和面向用户的视觉反馈。
  • 共享布局保持可交互,导航可中断。
  • 改善 Core Web Vitals:TTFB、FCP 和 TTI。

为进一步改善导航体验,Next.js 使用 <Link> 组件执行客户端过渡。

客户端过渡#

传统上,导航到服务端渲染的页面会触发整页加载。这会清除状态、重置滚动位置并阻断交互。

Next.js 通过使用 <Link> 组件的客户端过渡来避免这种情况。它不会重新加载页面,而是通过以下方式动态更新内容:

  • 保留所有共享布局和 UI。
  • 用预取的加载状态或可用的新页面替换当前页面。

客户端过渡使服务端渲染的应用感觉像客户端渲染的应用。当与预取和流式传输结合使用时,即使对于动态路由,也能实现快速过渡。

Next.js 还会在客户端过渡期间处理滚动到页面顶部。如果导航后内容滚动到粘性或固定头部之后,可以使用 CSS scroll-padding-top 修复此问题。

哪些因素会让过渡变慢?#

这些 Next.js 优化使导航快速且响应灵敏。然而,在某些情况下,过渡仍可能感觉很慢。以下是一些常见原因以及改善用户体验的方法:

没有 loading.tsx 的动态路由#

导航到动态路由时,客户端必须等待服务端响应才能显示结果。这可能会让用户觉得应用没有响应。

我们建议为动态路由添加 loading.tsx,以启用部分预取、触发即时导航,并在路由渲染时显示加载 UI。

app/blog/[slug]/loading.tsx
export default function Loading() {
  return <LoadingSkeleton />
}
app/blog/[slug]/loading.js
export default function Loading() {
  return <LoadingSkeleton />
}

小知识:在开发模式下,可以使用 Next.js Devtools 判断路由是静态还是动态。有关更多信息,请参阅 devIndicators。

没有 generateStaticParams 的动态段#

如果某个动态段本可以预渲染,但因为缺少 generateStaticParams 而未能预渲染,该路由将在请求时回退到动态渲染。

通过添加 generateStaticParams 确保路由在构建时静态生成:

app/blog/[slug]/page.tsx
export async function generateStaticParams() {
  const posts = await fetch('https://.../posts').then((res) => res.json())

  return posts.map((post) => ({
    slug: post.slug,
  }))
}

export default async function Page({
  params,
}: {
  params: Promise<{ slug: string }>
}) {
  const { slug } = await params
  // ...
}
app/blog/[slug]/page.js
export async function generateStaticParams() {
  const posts = await fetch('https://.../posts').then((res) => res.json())

  return posts.map((post) => ({
    slug: post.slug,
  }))
}

export default async function Page({ params }) {
  const { slug } = await params
  // ...
}

慢速网络#

在慢速或不稳定的网络上,预取可能在用户点击链接之前无法完成。这会影响静态和动态路由。在这些情况下,loading.js 的后备 UI 可能不会立即出现,因为它尚未被预取。

为了改善感知性能,可以使用 useLinkStatus hook 在过渡进行中显示即时反馈。

app/ui/loading-indicator.tsx
'use client'

import { useLinkStatus } from 'next/link'

export default function LoadingIndicator() {
  const { pending } = useLinkStatus()
  return (
    <span aria-hidden className={`link-hint ${pending ? 'is-pending' : ''}`} />
  )
}
app/ui/loading-indicator.js
'use client'

import { useLinkStatus } from 'next/link'

export default function LoadingIndicator() {
  const { pending } = useLinkStatus()
  return (
    <span aria-hidden className={`link-hint ${pending ? 'is-pending' : ''}`} />
  )
}

可以通过添加初始动画延迟(例如 100ms)并以不可见状态开始(例如 opacity: 0)来对此提示进行"防抖"。这意味着只有当导航耗时超过指定延迟时才会显示加载指示器。有关 CSS 示例,请参阅 useLinkStatus 参考。

小知识:实验性的 useOffline hook 可以在连接中断期间保持预取路由可导航。请参阅离线支持指南。

小知识:你可以使用其他视觉反馈模式,例如进度条。查看此处的示例。

禁用预取#

可以通过在 <Link> 组件上将 prefetch 属性设置为 false 来选择退出预取。这在渲染大型链接列表(例如无限滚动表格)时,可避免不必要的资源使用。

tsx
<Link prefetch={false} href="/blog">
  Blog
</Link>

不过,禁用预取也有权衡:

  • 静态路由只会在用户点击链接时获取。
  • 动态路由需要先在服务端渲染,客户端才能导航到它。

要在不完全禁用预取的情况下减少资源使用,可以仅在悬停时预取。这将预取限制在用户更可能访问的路由上,而不是视口中的所有链接。

app/ui/hover-prefetch-link.tsx
'use client'

import Link from 'next/link'
import { useState } from 'react'

function HoverPrefetchLink({
  href,
  children,
}: {
  href: string
  children: React.ReactNode
}) {
  const [active, setActive] = useState(false)

  return (
    <Link
      href={href}
      prefetch={active ? null : false}
      onMouseEnter={() => setActive(true)}
    >
      {children}
    </Link>
  )
}
app/ui/hover-prefetch-link.js
'use client'

import Link from 'next/link'
import { useState } from 'react'

function HoverPrefetchLink({ href, children }) {
  const [active, setActive] = useState(false)

  return (
    <Link
      href={href}
      prefetch={active ? null : false}
      onMouseEnter={() => setActive(true)}
    >
      {children}
    </Link>
  )
}

水合尚未完成#

<Link> 是一个 Client Component,必须先完成水合才能预取路由。在初次访问时,庞大的 JavaScript 包可能会延迟水合,导致预取无法立即开始。

React 通过 Selective Hydration 缓解了这一问题,你还可以通过以下方式进一步改善:

示例#

原生 History API#

Next.js 允许使用原生的 window.history.pushState 和 window.history.replaceState 方法来更新浏览器的历史记录栈,而无需重新加载页面。

Next.js 将 pushState 和 replaceState 调用集成到路由中,因此使用 usePathname 或 useSearchParams 渲染的组件会在 URL 变化时更新。当组件只在事件处理器中需要 URL 时,请在处理器中读取 window.location,而不要调用 usePathname 或 useSearchParams。这两个 hook 都会影响预渲染。

小知识:pushState 和 replaceState 会同步更新 window.location,而 Next.js 会将 usePathname 和 useSearchParams 的更新安排在 React Transition 中。同一事件处理器中的本地状态更新可能会在这些 hook 反映新 URL 之前就显示在屏幕上。

window.history.pushState#

使用它向浏览器的历史记录栈添加新条目。用户可以导航回先前的状态。例如,对产品列表排序:

tsx
'use client'

export default function SortProducts() {
  function updateSorting(sortOrder: string) {
    const params = new URLSearchParams(window.location.search)
    params.set('sort', sortOrder)
    window.history.pushState(null, '', `?${params.toString()}`)
  }

  return (
    <>
      <button onClick={() => updateSorting('asc')}>Sort Ascending</button>
      <button onClick={() => updateSorting('desc')}>Sort Descending</button>
    </>
  )
}
jsx
'use client'

export default function SortProducts() {
  function updateSorting(sortOrder) {
    const params = new URLSearchParams(window.location.search)
    params.set('sort', sortOrder)
    window.history.pushState(null, '', `?${params.toString()}`)
  }

  return (
    <>
      <button onClick={() => updateSorting('asc')}>Sort Ascending</button>
      <button onClick={() => updateSorting('desc')}>Sort Descending</button>
    </>
  )
}

window.history.replaceState#

使用它替换浏览器历史记录栈中的当前条目。用户无法导航回先前的状态。例如,切换应用程序的语言区域:

tsx
'use client'

export function LocaleSwitcher() {
  function switchLocale(locale: string) {
    // 例如 '/en/about' 或 '/fr/contact'
    const newPath = `/${locale}${window.location.pathname}`
    window.history.replaceState(null, '', newPath)
  }

  return (
    <>
      <button onClick={() => switchLocale('en')}>English</button>
      <button onClick={() => switchLocale('fr')}>French</button>
    </>
  )
}
jsx
'use client'

export function LocaleSwitcher() {
  function switchLocale(locale) {
    // 例如 '/en/about' 或 '/fr/contact'
    const newPath = `/${locale}${window.location.pathname}`
    window.history.replaceState(null, '', newPath)
  }

  return (
    <>
      <button onClick={() => switchLocale('en')}>English</button>
      <button onClick={() => switchLocale('fr')}>French</button>
    </>
  )
}
Next.js 中文网