NNext.js 中文网 GitHub

动态路由

动态路由是允许你在 URL 中添加自定义参数的页面。开始创建动态路由并在此了解更多。

当你事先不知道确切的分段名称,并希望根据动态数据创建路由时,可以使用在请求时填充或在构建时预渲染的动态分段。

约定#

可以通过将文件或文件夹名称括在方括号中来创建动态分段:[segmentName]。例如 [id] 或 [slug]。

可以通过 useRouter 访问动态分段。

示例#

例如,博客可以包含以下路由 pages/blog/[slug].js,其中 [slug] 是博客文章的动态分段。

jsx
import { useRouter } from 'next/router'

export default function Page() {
  const router = useRouter()
  return <p>Post: {router.query.slug}</p>
}
路由示例 URLparams
pages/blog/[slug].js/blog/a{ slug: 'a' }
pages/blog/[slug].js/blog/b{ slug: 'b' }
pages/blog/[slug].js/blog/c{ slug: 'c' }

捕获所有分段#

可以通过在方括号内添加省略号 [...segmentName],将动态分段扩展为捕获所有后续分段。

例如,pages/shop/[...slug].js 将匹配 /shop/clothes,也会匹配 /shop/clothes/tops、/shop/clothes/tops/t-shirts 等等。

路由示例 URLparams
pages/shop/[...slug].js/shop/a{ slug: ['a'] }
pages/shop/[...slug].js/shop/a/b{ slug: ['a', 'b'] }
pages/shop/[...slug].js/shop/a/b/c{ slug: ['a', 'b', 'c'] }

可选捕获所有分段#

通过将参数包含在双方括号中,可以将捕获所有分段设为可选:[[...segmentName]]。

例如,除了 /shop/clothes、/shop/clothes/tops、/shop/clothes/tops/t-shirts 之外,pages/shop/[[...slug]].js 还也会匹配 /shop。

捕获所有分段与可选捕获所有分段的区别在于,可选分段也会匹配不带参数的路由(上例中的 /shop)。

路由示例 URLparams
pages/shop/[[...slug]].js/shop{ slug: undefined }
pages/shop/[[...slug]].js/shop/a{ slug: ['a'] }
pages/shop/[[...slug]].js/shop/a/b{ slug: ['a', 'b'] }
pages/shop/[[...slug]].js/shop/a/b/c{ slug: ['a', 'b', 'c'] }
Next.js 中文网