SuperAPI AI 工具集

navigation

通用与其它

查看项目

更新于 10-15 23:41

技能介绍

用途:TanStack Router 中实现类型安全的客户端导航,覆盖声明式链接与编程式跳转。

主要能力:Link 组件支持 to 与 params 传参、activeProps/inactiveProps 激活样式、activeOptions 匹配控制(exact、includeHash、includeSearch),子元素可用 isActive 渲染函数;useNavigate 用于副作用驱动的编程式导航;Navigate 组件在挂载时立即跳转;router.navigate 可在 React 之外使用。支持 from 相对导航(.. 与 .),预加载策略 intent、viewport、render,可全局或按链接设置,默认预加载数据 30 秒内保持新鲜(defaultPreloadStaleTime: 30_000),配合外部缓存时可设为 0。useBlocker 可拦截导航,支持 withResolver 自定义 UI 与 enableBeforeUnload。linkOptions 提供导航选项的即时类型检查,createLink 可为自定义组件包装类型安全导航。滚动恢复通过 scrollRestoration、scrollToTopSelectors、getScrollRestorationKey 配置,Link 可用 resetScroll={false} 阻止重置。MatchRoute 用于 pending UI。

使用方式:动态段以 $ 声明,必须通过 params 传递,不可拼接进 to 字符串;相对路径需提供 from;search 传对象会替换全部参数,需用函数形式保留旧参数。

限制与注意:可点击元素应优先用 Link 而非 useNavigate,以保留 href、cmd+click、预加载与可访问性;useNavigate 仅用于表单提交等副作用场景。具体版本与安装命令资料未提供。