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页面,或在侧边模态框中打开购物车。