迷你组件库
你将构建什么
一组 4 个可复用组件,含变体(尺寸、颜色)、设计令牌文件和类 Storybook 演示页。
学习目标
- 为多个组件设计一致 API
- 用设计令牌管理颜色、间距和排版
- 通过 props 支持变体(primary/secondary、尺寸)
- 将组件组合到演示页
前置要求
- React 函数组件和 props
- CSS 或样式方案(CSS Modules、Tailwind 等)
- 组件组合(children prop)
步骤
- 1
定义设计令牌
创建含颜色(primary、secondary、danger)、间距(xs、sm、md、lg)和字号的令牌文件。这些是样式的唯一真相源。验收:所有组件引用令牌而非硬编码值。
提示
CSS 自定义属性(变量)效果佳:--color-primary: #3b82f6; 等。
- 2
构建 Button 组件
创建含 variant(primary/secondary/danger)和 size(sm/md/lg)props 的 Button。所有样式用令牌。验收:9 种组合(3 变体 × 3 尺寸)外观一致。
提示
转发 refs 并展开 ...props 使 button button 接受 onClick、disabled、type 等。
- 3
构建 Input 和 Card
创建含 label、error 和 helper text props 的 Input,以及含 header、body 和 footer 槽(用 children)的 Card。验收:两者与 Button 组合良好。
提示
Card 可用具名槽:<Card.Header>、<Card.Body>、<Card.Footer> 实现干净 API。
- 4
构建 Modal 组件
创建含 open/onClose props、背景和 Escape 关闭的 Modal。用 portal(createPortal)使模态渲染在 DOM 树外。验收:模态捕获焦点并在 Escape 和背景点击时关闭。
提示
createPortal 渲染到 document.body 使模态不被父级 overflow 或 z-index 裁剪。
- 5
构建演示页
创建展示每个组件和变体的页面——如迷你 Storybook。含表单(Input + Button)、内容卡片和按钮触发模态。验收:演示展示所有组件协同工作。
提示
此演示页兼作文档——任何人可看到组件及其 props 实际运行。
自己动手试试
你学到了什么
你构建了含设计系统的组件库——可扩展 UI 的基础。一致令牌和组件 API 是团队高效和 UI 协调的关键。
相关资源
相关课程
- React 组件
一致 API 的可复用组件。
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。