Skip to content

迷你组件库

中等 约 50 分钟

你将构建什么

一组 4 个可复用组件,含变体(尺寸、颜色)、设计令牌文件和类 Storybook 演示页。

学习目标

  • 为多个组件设计一致 API
  • 用设计令牌管理颜色、间距和排版
  • 通过 props 支持变体(primary/secondary、尺寸)
  • 将组件组合到演示页

前置要求

  • React 函数组件和 props
  • CSS 或样式方案(CSS Modules、Tailwind 等)
  • 组件组合(children prop)

步骤

  1. 1

    定义设计令牌

    创建含颜色(primary、secondary、danger)、间距(xs、sm、md、lg)和字号的令牌文件。这些是样式的唯一真相源。验收:所有组件引用令牌而非硬编码值。

  2. 2

    构建 Button 组件

    创建含 variant(primary/secondary/danger)和 size(sm/md/lg)props 的 Button。所有样式用令牌。验收:9 种组合(3 变体 × 3 尺寸)外观一致。

  3. 3

    构建 Input 和 Card

    创建含 label、error 和 helper text props 的 Input,以及含 header、body 和 footer 槽(用 children)的 Card。验收:两者与 Button 组合良好。

  4. 4

    构建 Modal 组件

    创建含 open/onClose props、背景和 Escape 关闭的 Modal。用 portal(createPortal)使模态渲染在 DOM 树外。验收:模态捕获焦点并在 Escape 和背景点击时关闭。

  5. 5

    构建演示页

    创建展示每个组件和变体的页面——如迷你 Storybook。含表单(Input + Button)、内容卡片和按钮触发模态。验收:演示展示所有组件协同工作。

自己动手试试

你学到了什么

你构建了含设计系统的组件库——可扩展 UI 的基础。一致令牌和组件 API 是团队高效和 UI 协调的关键。

相关资源

相关课程

查阅不认识的术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

查看术语表

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回主题