SuperAPI AI 工具集

moai-ref-react-patterns

前端与建站

查看项目

更新于 10-16 01:18

技能介绍

用途:为 React/Next.js 前端开发提供组件设计、状态管理与项目结构的参考规范,通常由前端任务调用后直接应用于组件设计与状态管理。

主要能力:组件设计模式包括复合组件(Context 共享隐式状态,适用于 Tab、Accordion、Dropdown、Select)、自定义 Hook 抽取(use 前缀,如 useForm、useDebounce、useAuth)、容器与展示组件分离、无头组件(如 useCombobox、useDialog、useTable)。状态管理选型:组件内部用 useState/useReducer,服务端状态用 React Query/TanStack Query,全局客户端用 Zustand,复杂全局用 Zustand + Immer,URL 状态用 nuqs/useSearchParams,表单用 React Hook Form + Zod,主题与国际化用 Context + Provider。决策顺序为:可从 URL 恢复则用 URL 状态,服务端数据用 React Query,跨组件共享用 Zustand,组件内部用 useState,复杂状态转换用 useReducer。

项目结构:给出 Next.js App Router 的 src 目录组织,含 app 路由组与 API Routes、components/ui 与 components/features、hooks、lib、stores、types、styles。质量与性能规范包括组件 200 行以内、props 不超过 5 个、异步操作提供加载态、页面级错误边界、客户端与服务端双重校验,以及 memo、懒加载、虚拟化、图片优化、乐观更新、防抖等模式。错误处理按 401/403/404/422/429/500 给出客户端处理方式,并附无障碍检查清单与验证项。

限制:资料未提供安装命令、收费方式与具体平台支持信息。