SuperAPI AI 工具集

tanstack-router-core-navigation

通用与其它

查看项目

更新于 10-16 00:02

技能介绍

用途:介绍 TanStack Router 的核心导航能力,覆盖类型安全的声明式与命令式跳转、相对路径解析、预加载、导航拦截与滚动恢复。

主要能力:Link 组件支持 to 与 params 的类型安全跳转,可通过 activeProps/inactiveProps/activeOptions 控制激活态,激活链接会设置 data-status="active";子元素可用渲染函数接收 isActive;activeOptions 含 exact、includeHash、includeSearch。from 用于相对导航,不提供时从根解析;to=".." 返回上级,to="." 重载当前路由。useNavigate 用于副作用驱动的编程式导航;Navigate 组件在挂载时立即做客户端跳转;有 router 实例时可用 router.navigate。预加载策略有 intent、viewport、render,可全局或按链接设置,默认 staleTime 为 30 秒。useBlocker 可阻止未保存表单离开,支持 withResolver 自定义 UI 与 enableBeforeUnload。linkOptions 提供提前类型检查,可复用于 Link、navigate、redirect 及数组导航栏。createLink 可为自定义组件包装类型安全导航。滚动恢复支持 scrollRestoration、scrollToTopSelectors 与自定义 key。MatchRoute 用于 pending UI。

限制与易错点:不要把参数插值进 to 字符串,应传 params;点击元素优先用 Link 而非 useNavigate,否则丢失 href、cmd+click、预加载与可访问性;相对导航必须提供 from;search 传对象会替换全部参数,应用函数形式展开前值。此资料未提供具体版本要求与安装步骤。