用途:从零构建新组件、重构已有组件、设计组件 API(props、slots、事件)、为组件补充无障碍支持,或按设计稿实现组件。不适用于构建完整设计系统、页面级设计决策、后端数据工作或纯性能优化。
主要能力:从六个维度定义完整组件。一是结构(anatomy),如按钮由容器、标签、可选图标与加载指示组成,模态框由遮罩、容器、头、主体、底、关闭控件组成。二是变体(variants),含视觉、尺寸、功能变体,应作为受控集合管理。三是状态,含默认、悬停、聚焦、按下、禁用、加载、错误、空状态,每个状态都需视觉与无障碍双重处理。四是 Props/API,要求必需 props 最小化,警惕布尔 props 泛滥,优先使用枚举字符串,用 children 代替内容 props,以组合代替配置,并做类型标注。五是无障碍,优先语义 HTML 而非 div,保证键盘可导航、焦点可见、点击目标至少 44x44 像素,仅在语义 HTML 不足时使用 ARIA,并给出按钮、模态框、表单、切换、标签页、提示框、加载状态的具体模式。六是测试,按优先级包括视觉回归、无障碍自动检查(如 axe)、键盘导航、组件逻辑与集成测试,缺少自动化无障碍测试不算完成。
使用方式:先理解用例并画结构草图,列出变体与状态,设计 API,用语义 HTML 写标记,使用设计令牌而非硬编码,添加交互与状态,进行测试,最后编写文档。交付物包含组件代码、Storybook 条目、含结构、API 表、用法示例、反模式与无障碍说明的文档,以及测试。参考文件包括组件规格模板、组件 API 模式与无障碍模式。
限制:资料未提供具体安装命令、价格、支持平台版本或实际运行效果;技能本身为原则性指导,具体 API 与工具链需结合所用框架确定。