组件组合设计
用组合模式设计 React 组件 API,避免布尔属性泛滥和难维护的组件结构。
功能与用途
本规范用于指导 React 组件的组合式 API 设计与重构,旨在消除布尔属性泛滥的顽疾。使用者输入存在扩展瓶颈的旧组件代码或新组件设计诉求,即可获得基于复合组件、状态提升和上下文接口的标准化架构方案与代码实现。输出结果支持高内聚组装与深度定制。使用门槛为掌握 React 核心机制及 Context 状态分发原理。
适用场景
- 多布尔属性组件重构:消除为了定制各类展示行为而不断累加的布尔控制参数,改为显式变体组件和子组件自由组合。
- 可复用组件库架构设计:借助复合组件模式与统一的上下文接口设计组件库,让使用者能灵活嵌套子元素并共享内部状态。
- 复杂交互组件的状态解耦:将内部状态提升至 Provider 统一管控,仅向外暴露标准接口,降低复杂业务组件的维护成本。
适用人群
- 前端工程师
- 组件库维护者
- React 开发者
使用步骤
- 找出布尔属性泛滥或条件逻辑复杂的组件
- 按组件架构优先级先判断是否该改用组合或复合组件
- 把共享状态提升进 provider 组件,定义清晰的 context 接口
- 用显式变体替代隐式的行为开关
- 涉及 React 19 的部分对照对应 API 规则检查
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 入门
- 版本
- master
- 最近更新
- 2026-09-17
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
React composition patterns that scale. Use when refactoring components with
使用前准备
- 一个 React 项目或组件代码
- 要重构的目标组件
依赖与权限
- 读取用户主动提供的内容