工程开发
Parallel Routes Generator avatar

Parallel Routes Generator

实现 Next.js Parallel Routes 模态窗口以消除页面布局偏移 (layout shifts)。适用于对话框、模态窗口及拦截路由 (intercepted routes)。

简介

Parallel Routes Generator 是一项专为使用 App Router 的 Next.js 应用程序所设计的工程技能。它为处理模态窗口 (modals) 与对话框 (dialogs) 提供了一套标准化架构模式,确保视图之间的导航不会触发不必要的页面布局偏移 (layout shifts),从而显著提升用户体验与技术稳定性。通过运用 Next.js 的平行路由 (Parallel Routes) 与拦截路由 (Intercepted Routes) 功能,此工具能够创造流畅的切换效果,让内容以浮动窗口呈现,同时维持底层页面作为背景插槽,确保透过直接 URL 访问时仍能正确渲染完整页面。

  • 自动配置目录结构中的 @modal 插槽模式。

  • 标准化 default.tsx 的实现,确保模态窗口在未激活时能被安全地处理为 null。

  • 实现 (..) 拦截路由,以维持客户端导航与直接链接行为的一致性。

  • 提供可重复使用的 Modal 组件,利用 @radix-ui/react-dialog 确保无障碍访问性与键盘焦点管理。

  • 整合 useRouter 钩子,在关闭模态窗口时自动处理后退导航行为。

  • 强制执行此模式于所有模态相关 UI 任务,以防止状态管理不一致。

  • 当用户提及 'modal'、'dialog'、'popup'、'parallel route' 或 'intercepted route' 时,应触发此技能。

  • 输入:目标路由路径与拟显示于模态窗口的组件内容。

  • 输出:功能完整且具无障碍性的 React Modal 组件、对应的路由插槽文件夹结构,以及必要的 layout 注入代码。

  • 限制:需具备现有的 App Router 设置;必须严格遵循项目中定义的 parent/slot 布局架构。

  • 最佳实践:务必确保 layout.tsx 文件同时接受 {children} 与 {modal} 属性,以防止运行时的插槽错误。

仓库统计

Star 数
0
Fork 数
0
Open Issue 数
0
主要语言
TypeScript
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 23:33
在 GitHub 查看