UI 视觉设计 / 系统课时
把图标做成可复用组件
把图标做成可复用组件
图标进入真实产品后,会同时出现在按钮、导航、表格和状态提示中。仅保存一批 SVG 文件很容易产生复制、改色和尺寸分叉。本篇把图形源、组件属性和必要变体拆开,让同一个图标能稳定生成不同界面的实例,同时保持后续修改可以集中回收。
学习目标
- 区分图标源组件、实例、属性与变体各自负责的内容
- 用有限属性覆盖尺寸、颜色和无障碍等常见使用差异
- 判断什么时候应该新增变体,什么时候应该继续复用同一组件
先把图形源和使用方式拆开
可复用图标的核心不是“做很多组件”,而是让一份图形定义成为唯一来源。页面中的按钮、菜单或提示只引用它的实例,不复制内部路径。这样修正轮廓、像素对齐或命名时,改动能够沿组件关系传播,而不是逐个查找散落资产。

组件内部应固定真正属于图标身份的内容,例如 viewBox、路径结构、基准尺寸和描边规则。调用方需要改变的内容再做成属性,例如显示尺寸、继承颜色和无障碍名称。不要把“红色搜索图标”“蓝色搜索图标”各做成一个变体,因为颜色通常属于界面上下文,而不是图标自身。
用属性代替复制出来的新图标
在代码侧也应保持相同原则:一个组件保存几何结构,通过参数改变展示方式。下面是片段示例,依赖已有 React 与 TypeScript 项目;它用 size 控制显示尺寸,并默认通过 currentColor 继承父级文字颜色。
import type { SVGProps } from "react";
type SearchIconProps = Omit<SVGProps<SVGSVGElement>, "width" | "height"> & {
size?: number;
title?: string;
};
export function SearchIcon({
size = 24,
title,
...props
}: SearchIconProps) {
const semantic = Boolean(title);
return (
<svg
viewBox="0 0 24 24"
width={size}
height={size}
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
role={semantic ? "img" : undefined}
aria-label={title}
aria-hidden={semantic ? undefined : true}
{...props}
>
<circle cx="11" cy="11" r="7" />
<path d="m20 20-4-4" />
</svg>
);
}预期结果
同一个 SearchIcon 可按调用位置改变尺寸和颜色;传入 title 时作为有语义的图片暴露给辅助技术,不传 title 时作为装饰图标隐藏。这里没有提供 color 属性,因为 SVG 已通过 currentColor 使用上下文颜色,调用方可以用现有样式系统统一控制。如果组件再额外维护一套颜色枚举,往往会把图标组件和主题系统重复绑定。
只为真实的几何差异建立变体
属性适合处理“同一图形的不同展示参数”,变体适合处理“同一语义下确实存在不同图形”。两者混用会让组件面板迅速膨胀。
| 差异 | 更适合的结构 | 原因 |
|---|---|---|
| 16、20、24 像素显示尺寸 | 属性 | 几何身份没有变化 |
| 深色、浅色或品牌色 | 样式或主题 | 颜色由使用环境决定 |
| 描边版与填充版 | 变体 | 内部路径和视觉重量不同 |
| 左向与右向且必须重新绘制 | 变体 | 不是简单缩放参数 |
| 是否提供语义名称 | 属性 | 只改变可访问性行为 |
即使存在变体,也应让名称表达一个稳定维度,例如 style=outline|filled,而不是把多个条件揉成 small-blue-filled 这种组合名称。后者会让新增尺寸或主题时产生组合爆炸。
发布前验证组件是否真的可复用
检查一个图标组件时,不要只看它在设计稿中是否正确,还要尝试把它放到几个不同上下文中。实例应能直接切换尺寸或继承颜色,而不需要解除组件关系;修改源图标后,已有实例不应出现意外偏移;装饰性图标和具有独立含义的图标还应能分别处理无障碍信息。
如果调用方经常需要绕过组件、覆盖内部路径或复制出新文件,说明当前属性边界没有覆盖真实需求。可维护的图标组件不是属性越多越好,而是让高频差异有明确入口,同时继续把图形本身收敛到一个可追踪的来源。