设计系统无障碍文档
Typeflow 设计系统
面向多端产品的设计令牌与组件库,覆盖 4 个产品线、120+ 组件。
- 角色
- 核心维护者
- 周期
- 2023-02 ~ 2024-05
- 技术栈
- TypeScript · React · CSS Variables · Storybook
背景
四条产品线各自维护一套组件,颜色、间距与交互行为不一致,设计走查成本高。目标是建立单一令牌来源与可组合的组件层。
我的职责
- 定义令牌命名与主题切换机制
- 实现表单、弹层、导航等基础组件
- 建立无障碍验收清单并接入 CI
方案与取舍
令牌分三层:原始值、语义值、组件值。业务只允许引用语义层,避免直接写死色值。主题切换通过 data-theme 覆盖 CSS 变量,不引入运行时样式库。
结果与复盘
组件复用率提升到 78%,无障碍问题从 214 个降到 9 个。最大的教训是文档比组件更重要:没有可搜索的示例,组件再好在业务侧也会被绕开。