SuperAPI AI 工具集

react-router-v7

前端与建站

查看项目

更新于 10-16 09:53

技能介绍

用途:面向使用 React Router v7(框架模式,Vite 插件 + SSR)的全栈前端项目,规范路由、数据加载、表单变更、鉴权与错误处理写法。

主要能力:

  • 基于文件的路由(src/routes/ 目录),支持布局路由、动态段(:id)、可选段(:lang?)、splat(*)与 404 catch-all($.tsx)。
  • 数据优先:用 loader 做服务端数据获取,用 action 处理表单提交与变更;组件通过 loaderData / actionData 取数。
  • 表单用 <Form method="post">,服务端校验后通过 action 返回错误,或用 redirect 跳转;内联更新、无需改 URL 时用 useFetcher。
  • 导航组件 Link、NavLink、useNavigate,NavLink 支持 isActive 激活态。
  • 鉴权工具来自 ~/cookies/auth.server:getAuthSession、getAccessTokenOrRedirect(未登录自动跳转)、logoutRedirect。
  • HTTP 工具来自 ~/services/http.server:httpRequest(公开接口)、authRequest(自动带 Bearer 令牌),支持超时、重试与 errorHandler。
  • React Query 仅用于 loader 超时后的重试:把 loaderData 作为 initialData,并用 enabled 控制避免重复请求。
  • 用 ErrorBoundary 与 isRouteErrorResponse、useRouteError 处理路由错误。
  • 组件可复用 @projectx/ui,样式用 Tailwind CSS v4 与 DaisyUI;类型由生成的 +types 文件提供。

使用方式: 路由在 routes.ts 中用 index/route/layout 定义,或采用文件路由约定。开发运行:pnpm dev:web;生产构建:pnpm build:web;类型检查:pnpm --filter web typecheck;组件预览:pnpm storybook。

适用场景: 需要 SSR 的全栈 React 应用、带鉴权的后台与受保护路由、依赖 loader/action 的数据流架构。

限制: 资料仅描述该项目的框架模式用法;数据模式与声明式模式仅作对照,未给出完整配置。React Query 在本项目中限定用于超时重试。未提供的功能、收费、平台与效果信息暂未提供。