Intercepting Routes

拦截路由允许你在当前布局中加载应用程序另一部分的路由。当你想要显示路由内容而不需要用户切换到不同上下文时，这种路由范式非常有用。

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

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

约定

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

你可以使用：

• (.) 匹配同级的段
• (..) 匹配上一级的段
• (..)(..) 匹配上两级的段
• (...) 匹配从 root app 目录开始的段

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

值得注意的是：(..) 约定基于_路由段_，而不是文件系统。例如，它不考虑并行路由中的 @slot 文件夹。

示例

模态框

拦截路由可以与并行路由一起使用来创建模态框。这使你能够解决构建模态框时的常见挑战，例如：

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

考虑以下 UI 模式，用户可以使用客户端导航从图库打开照片模态框，或直接从可分享的 URL 导航到照片页面：

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

查看并行路由文档以获取分步示例，或查看我们的图片画廊示例。

值得注意的是：

• 其他示例可能包括在顶部导航栏中打开登录模态框，同时还有一个专门的 /login 页面，或在侧边模态框中打开购物车。