SuperAPI AI 工具集

router-core

前端与建站

查看项目

更新于 10-16 00:00

技能介绍

用途:router-core 是 TanStack Router 的框架无关核心技能,面向基于该库的客户端路由开发,按子技能组织知识。

主要能力:包含九个子技能——搜索参数(校验、读取、写入、转换)、路径参数(动态段、splat、可选参数)、导航(Link、useNavigate、预加载、阻断)、数据加载(loader、SWR 缓存、context、延迟数据)、鉴权与守卫(beforeLoad 重定向、RBAC)、代码分割(自动与手动)、404 与错误处理(notFound()、错误边界)、类型安全(推断、Register、from 收窄、TS 性能)、SSR(流式/非流式、水合、head 管理)。

使用方式:提供最小示例。以 createRootRoute 定义根路由、createFileRoute 定义文件路由;在 router.tsx 用 createRouter({ routeTree }) 创建实例,并通过 declare module 注册 Register 以获得 Link/useNavigate 自动补全;main.tsx 用 RouterProvider 渲染。

关键限制:类型完全推断,不应手动标注或强制转换;该库为客户端优先,loader 默认在客户端运行,切勿与 Next.js、React Router 的 API 混淆;createFileRoute 的路径字符串由 Vite 插件生成,必须与 src/routes 下文件位置一致,不要手改;splat 路由使用 $,* 兼容别名将在 v2 移除。版本为 v1.166.2。其他信息暂未提供。