SuperAPI AI 工具集

react-patterns

前端与建站

查看项目

更新于 10-16 05:06

技能介绍

用途:在构建 React 应用时提供可维护的组件编写与状态管理实践,覆盖组件组合、自定义 Hook、类型定义、性能优化、错误处理与加载状态。适用 Web 和移动端共享的 React 模式;React Native 专属模式请参考 react-native-patterns。

主要能力:

  1. 组件组合:复合组件(Compound Components,父子通过 Context 共享隐式状态)、插槽模式(Slot Pattern,用具名 props 灵活组合)。
  2. React 19 特性:use() 解包 Promise 与 Context;useActionState 处理表单动作与 pending 状态;useOptimistic 实现乐观更新。
  3. 自定义 Hook:对象返回多个具名值、元组返回、Hook 组合(如 useLocalStorage)。
  4. TypeScript 集成:扩展 HTML 元素 props、泛型组件类型推导、React 19 中用 ref 作为普通 prop(forwardRef 已废弃)。
  5. 状态管理:useReducer 处理复杂状态。
  6. 性能:memo + useCallback 减少重渲染,lazy + Suspense 懒加载。
  7. 错误处理:ErrorBoundary 捕获渲染错误,Suspense 包裹异步数据加载。

使用方式:按工作流选择组件组合模式、应用 TypeScript 类型、实现自定义 Hook、按需性能优化、用 Suspense/错误边界处理加载与错误、验证渲染行为。完整 React API 参考可通过 Context7 MCP 获取(mcp__context7__resolve-library-id → react)。

反馈循环:组件渲染无 TypeScript 错误、props 正确类型化、自定义 Hook 有清晰返回类型、无多余重渲染(用 React DevTools Profiler 验证)、错误边界能捕获错误、加载状态与 Suspense 协同。

限制与反模式:React 19 不使用 forwardRef;新代码不用类组件;不直接修改 state;不要遗漏依赖数组;避免过度使用 useMemo/useCallback(先 profiling);Context 不宜滥用;不在 useState 中放派生状态、不用 useEffect 处理派生状态;列表 key 用稳定唯一 ID 而非索引;不用 any 或 // @ts-ignore 绕过 TypeScript 错误。具体安装命令与版本要求暂未提供。