本资料介绍 TanStack Router 的导航功能。核心是用类型安全的 Link 组件声明式跳转,动态段以 $ 声明并通过 params 传入,如 <Link to="/posts/$postId" params={{ postId }}>。可用 activeProps、inactiveProps、activeOptions 控制激活样式,激活链接会带 data-status="active",也可通过渲染函数拿到 isActive。相对路径需提供 from(如 Route.fullPath),否则 .. 会从根路径解析;to="." 表示重载当前路由。副作用驱动的跳转用 useNavigate,组件挂载即跳转用 Navigate,React 之外可用 router.navigate。预加载策略有 intent、viewport、render,可全局或按链接设置 preload 与 preloadDelay,预加载数据默认新鲜 30 秒,配外部缓存时可设 defaultPreloadStaleTime: 0。导航拦截用 useBlocker,可用 withResolver 自定义确认 UI,也可用 enableBeforeUnload 控制页面卸载。linkOptions 提供导航选项的即时类型检查,可复用于 Link、navigate、redirect 及导航栏数组。createLink 可为自定义组件接入类型安全导航。滚动恢复通过 router 的 scrollRestoration 开启,可设 scrollToTopSelectors、getScrollRestorationKey,单次导航可用 resetScroll={false}。MatchRoute 的 pending 可用于待处理 UI。常见错误包括把 params 拼进 to 字符串、对可点击元素用 useNavigate、相对导航缺少 from、用对象形式的 search 覆盖全部查询参数(应改用函数式更新)。
router-core/navigation
通用与其它
更新于 10-16 10:22