用途:面向 React + TypeScript 的惯用组件设计参考,用于构建、评审或重构组件时保证类型安全、可组合性与性能。
主要能力:组合优于继承,通过 props 与 children 组合而非类继承;Props API 设计,用可辨识联合约束变体 props 的合法组合;children 内容投影,仅在子组件需要父级数据时使用 render props;多态 as prop,在保持类型安全下更换渲染元素;复合组件,通过 Context 共享隐式状态并以点号暴露子组件;受控与非受控,检测 value 是否传入以同时支持两种模式;memoization 决策,仅在实测存在性能问题时使用 React.memo,useMemo 用于昂贵派生值,useCallback 用于稳定函数引用;forwardRef 用于包装 DOM 元素的可复用基础组件。
反模式:超过两层的 prop drilling、超过 200 行或 5 个以上 state 的上帝组件、用 useEffect 同步派生状态、超过两个布尔 props 的爆炸式组合。
限制:资料未提供安装命令、版本要求、平台或收费信息。