UI 视觉设计 / 系统课时

完成一套图标系统验收

完成一套图标系统验收

图标系统做到“能导出”还不等于可以交付。本节把规范、资产、组件、语义和交付物放进同一套验收流程,建立可复查的通过标准,并用自动检查与人工抽样组合,避免上线后才暴露命名、尺寸、颜色或语义不一致的问题。

学习目标

  • 建立覆盖规范、资产、组件、语义和交付结果的验收清单
  • 区分适合自动检查与必须人工判断的项目
  • 形成可重复执行、能持续迭代的验收闭环

先把“通过”定义成可检查的条件

验收的第一步不是逐个看图标,而是把“看起来一致”改成可观察的条件。建议先冻结本次发布的基线:画布尺寸、描边策略、圆角、颜色继承方式、命名规则、组件接口、无障碍要求和文件目录都要有明确版本。

层级 重点检查 典型通过条件
规范 网格、尺寸、描边、视觉重量 新图标能按同一规则重建
资产 文件名、viewBox、颜色、重复文件 文件可被构建工具稳定识别
组件 尺寸、颜色、状态、可访问性 同一 API 能覆盖常用场景
语义 名称、用途、方向性、状态含义 同一图标不会承担冲突语义
交付 版本、文档、变更记录、包产物 使用方能定位版本并完成接入

验收项还应标记严重级别。会导致错误显示、错误语义、构建失败或破坏兼容性的项目应阻断发布;仅影响后续整理的项目可以记录为待办,但必须明确负责人和处理版本。

按固定顺序完成验收

先检查规范基线,再做资产扫描,然后抽样组件渲染和语义场景,最后核对交付物。这样能先发现低成本、可批量修复的问题,避免在组件层反复追查其实来自源文件的错误。

图标系统验收闭环

自动检查适合处理“机器能明确判定”的规则,例如文件命名、固定画布、非法颜色和缺失文件;人工抽样则用于视觉重量、隐喻是否准确、方向性是否符合场景,以及不同尺寸下是否仍然清晰。

用脚本拦住可机械发现的问题

下面脚本只使用 Node.js 内置模块,检查目录中的 SVG 是否采用短横线命名、是否使用 0 0 24 24 的 viewBox,以及是否出现除 none 和 currentColor 之外的硬编码 fill。如果你的系统允许双色或填充图标,应把对应规则改成项目自己的白名单。

js
import { readdir, readFile } from "node:fs/promises";
import { extname, join } from "node:path";

const root = process.argv[2];

if (!root) {
  console.error("Usage: node validate-icons.mjs <PATH>");
  process.exit(2);
}

const files = (await readdir(root))
  .filter((name) => extname(name) === ".svg")
  .sort();

const issues = [];

for (const name of files) {
  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*\.svg$/.test(name)) {
    issues.push(`${name}: invalid file name`);
  }

  const svg = await readFile(join(root, name), "utf8");

  if (!/viewBox="0 0 24 24"/.test(svg)) {
    issues.push(`${name}: unexpected viewBox`);
  }

  if (/fill="(?!none|currentColor)[^"]+"/.test(svg)) {
    issues.push(`${name}: hard-coded fill`);
  }
}

if (issues.length > 0) {
  console.error(issues.join("\n"));
  process.exit(1);
}

console.log(`PASS ${files.length} icons`);

保存为 validate-icons.mjs 后,在项目根目录执行:

bash
node validate-icons.mjs <PATH>

预期输出:

text
PASS <COUNT> icons

<PATH> 替换为 SVG 目录,<COUNT> 会随实际文件数量变化。脚本返回非零退出码时,应先修复资产问题,再进入组件和语义抽样,避免把已知错误带到后续阶段。

人工抽样要覆盖真实使用场景

人工验收不要只挑首页里最常见的几个图标。至少覆盖导航、操作、状态、方向、品牌例外和危险操作等语义类型,并在常用尺寸、禁用态、深浅背景和高对比环境中查看。组件层还要确认图标不会因为容器尺寸、行高或对齐方式而出现额外偏移。

语义检查尤其要关注“图形正确但意思错误”的情况。例如同一个叉号既表示关闭又表示删除,会让用户依赖上下文猜测;向左箭头在返回、撤销、折叠三种场景中也可能需要不同命名或组件封装。此类问题无法靠 SVG 扫描判断,必须结合产品场景复核。

把验收结果变成下一次发布的输入

一次验收应留下三类结果:本次通过的基线版本、被阻断并已修复的问题、允许延期但已有负责人与目标版本的改进项。发布后新增图标也必须沿用同一入口,而不是临时把 SVG 丢进目录。

当规范变更时,先更新基线和自动检查,再批量迁移资产,最后回归组件与语义场景。这样验收就不再是发布前的一次性检查,而是图标系统持续演进的质量门槛:任何新资产进入系统前,都能用同一套规则判断它是否真的“属于这套系统”。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

完成一套图标系统验收

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通