用途:整理 TanStack Router 的路由导航用法,覆盖声明式跳转与编程式跳转,面向 React 应用。
主要能力:Link 组件支持 to 与 params 的类型安全跳转,提供 activeProps、inactiveProps、activeOptions(exact、includeHash、includeSearch),激活时设置 data-status="active",子节点可通过 render 函数拿到 isActive。useNavigate 用于副作用驱动的跳转,如表单提交后;Navigate 组件挂载即执行客户端跳转;router.navigate 可在 React 之外使用。提供 from 支持 ..、. 等相对导航;preload 支持 intent、viewport、render,可全局 defaultPreload 或逐链接设置,配合 defaultPreloadDelay 与 defaultPreloadStaleTime(默认 30 秒,外部缓存如 TanStack Query 建议设 0)。useBlocker 可拦截未保存表单的离开,支持 withResolver 自定义 UI 及 enableBeforeUnload。linkOptions 对导航选项做即时类型检查,并可用于数组渲染导航栏。createLink 为自定义组件包裹类型安全导航。scrollRestoration 支持 scrollToTopSelectors、getScrollRestorationKey 及 Link 的 resetScroll。MatchRoute 用于 pending UI。
注意:动态段以 $ 声明,须通过 params 传入,不可把参数插值进 to 字符串;可点击元素优先用 Link 而非 useNavigate;相对路径需提供 from;search 传对象会替换全部参数,需保留时用函数形式。
限制:官方收费、平台等信息暂未提供。