NNext.js 中文网 GitHub

Intercepting Routes

使用拦截路由在当前布局内加载新路由,同时隐藏浏览器 URL,适用于模态框等高级路由模式。

拦截路由允许你在当前布局内加载应用中其他位置的路由。当你希望在不让用户切换上下文的情况下显示某个路由的内容时,这种路由范式非常有用。

例如,当点击信息流中的照片时,你可以在模态框中显示该照片,覆盖在信息流之上。在这种情况下,Next.js 会拦截 /photo/123 路由,隐藏 URL,并将其覆盖在 /feed 之上。

但是,当通过点击可分享的 URL 或刷新页面来导航到照片时,应渲染整个照片页面而不是模态框。不应发生路由拦截。

约定#

拦截路由可以使用 (..) 约定来定义,它类似于相对路径约定 ../,但用于路由片段。

你可以使用:

  • (.) 匹配同一层级的片段
  • (..) 匹配上一层级的片段
  • (..)(..) 匹配上两个层级的片段
  • (...) 匹配来自 根 app 目录的片段

例如,你可以通过创建 (..)photo 目录,从 feed 片段中拦截 photo 片段。

小知识: (..) 约定基于路由片段,而不是文件系统。例如,它不考虑 Parallel Routes 中的 @slot 文件夹。

示例#

模态框#

拦截路由可以与 Parallel Routes 一起使用来创建模态框。这使你可以解决构建模态框时的常见难题,例如:

  • 使模态框内容可通过 URL 分享。
  • 页面刷新时保留上下文,而不是关闭模态框。
  • 向后导航时关闭模态框,而不是转到上一个路由。
  • 向前导航时重新打开模态框。

考虑以下 UI 模式,用户可以通过客户端导航从图库中打开照片模态框,也可以直接从可分享的 URL 导航到照片页面:

在上面的示例中,指向 photo 片段的路径可以使用 (..) 匹配器,因为 @modal 是一个 slot 而不是片段。这意味着 photo 路由只高一个片段层级,尽管它在文件系统上高两个层级。

有关分步示例,请参阅 Parallel Routes 文档,或查看我们的图片库示例。

小知识:

  • 其他示例包括在顶部导航栏中打开登录模态框,同时也有专门的 /login 页面,或在侧边模态框中打开购物车。
Next.js 中文网