Parallel Routes Generator
實作 Next.js Parallel Routes 模態視窗以消除版面位移 (layout shifts)。適用於對話框、模態視窗與攔截路由 (intercepted routes)。
簡介
Parallel Routes Generator 是一項專為使用 App Router 的 Next.js 應用程式所設計的工程技能。它為處理模態視窗 (modals) 與對話框 (dialogs) 提供了一套標準化架構模式,確保視圖之間的導航不會觸發非預期的版面位移 (layout shifts),進而顯著提升 UX 與技術穩定性。透過運用 Next.js 的平行路由與攔截路由功能,此技能可創造流暢的切換效果,讓內容以浮動視窗呈現,同時維持底層頁面作為背景插槽,確保透過直接 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日 下午11:33