UI 视觉设计 / 系统课时
导出规范 SVG 资源
导出规范 SVG 资源
SVG 交付的目标不是“设计工具里看起来正常”,而是让开发拿到后可以直接复用、换色、缩放和审查。本节从路径、描边、viewBox、命名和冗余数据入手,整理一套可验证的导出规则,避免资源在组件化后出现尺寸漂移或主题色失效。
学习目标
- 建立适合开发接入的 SVG 文件契约,明确尺寸、颜色和命名边界。
- 清理会影响缩放、换色或维护的路径、描边与编辑器冗余数据。
- 使用脚本在交付前检查
viewBox、固定尺寸、硬编码颜色和文件名。
先固定开发侧资源契约
导出前先约定“资源由谁控制尺寸和颜色”。如果图标会进入前端组件库,通常让组件控制外部尺寸,让 SVG 只保留稳定坐标系;颜色则优先使用 currentColor,使图标跟随文本色或设计令牌,而不是把品牌色写死在路径中。
常见的 24 像素图标可以统一采用 viewBox="0 0 24 24"。若团队约定由 CSS 或组件属性控制大小,源文件不再写固定 width、height。文件名使用小写短横线,例如 icon-search.svg,不要混用空格、中文、下划线和版本尾缀。
清理路径、描边和颜色
导出后重点检查几何是否仍符合规范。描边图标需要统一 stroke-width、端点和转角规则;不要因为轮廓化操作把本来可维护的描边全部变成复杂填充路径。只有在跨工具兼容或字体轮廓等明确场景下,才把描边转路径。
颜色也要区分“语义颜色”与“资源固有颜色”。普通单色功能图标适合使用 currentColor;多色品牌标识、插画或状态图形则不应机械替换。若同一文件同时出现多个接近但不同的硬编码色值,通常意味着导出前还没有完成样式归一。
校验视图框和冗余数据
viewBox 应覆盖完整图形,同时保留设计规范要求的安全边距。路径若超出视图框,运行时会被裁切;视图框过大则会让视觉主体显得偏小。还要检查是否遗留编辑器专用命名空间、无用分组、空的 defs、不可见图层或重复变换。
对于交付给组件库的纯资源文件,通常无需携带设计工具的图层名称和内部 ID。若某些 id 被渐变、蒙版、裁剪路径或 use 引用,则必须保留并保证唯一,不能为了“文件更干净”直接删除。
用脚本做交付前检查
下面的命令会创建一个可复用的 24 像素搜索图标,并用 Node.js 检查四项交付规则:文件名、viewBox、是否存在固定宽高、是否出现硬编码颜色。示例只依赖 Node.js 内置模块。
# 源资源只保留稳定坐标系和可继承的主题色。
cat > icon-search.svg <<'SVG'
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none">
<circle cx="11" cy="11" r="6.5"
stroke="currentColor" stroke-width="2" />
<path d="M16 16L21 21"
stroke="currentColor" stroke-width="2" stroke-linecap="round" />
</svg>
SVG
# 校验脚本把可自动判断的交付规则固定下来。
cat > validate-svg.mjs <<'JS'
import { readFileSync } from 'node:fs';
import { basename } from 'node:path';
const file = process.argv[2];
if (!file) throw new Error('usage: node validate-svg.mjs <file.svg>');
const svg = readFileSync(file, 'utf8');
const checks = [
['filename', /^[a-z0-9]+(?:-[a-z0-9]+)*\.svg$/.test(basename(file))],
['viewBox', /viewBox="0 0 24 24"/.test(svg)],
['flexible-size', !/<svg[^>]*\b(?:width|height)=/i.test(svg)],
['theme-color', /(?:stroke|fill)="currentColor"/.test(svg) &&
!/(?:#[0-9a-f]{3,8}\b|rgb\()/i.test(svg)]
];
const failed = checks.filter(([, ok]) => !ok).map(([name]) => name);
if (failed.length) {
console.error(`FAIL ${file}: ${failed.join(', ')}`);
process.exit(1);
}
console.log(`OK ${file}: viewBox=24, flexible-size, theme-color`);
JS
# 在交付目录执行检查,失败时以非零状态码退出。
node validate-svg.mjs icon-search.svg预期输出
OK icon-search.svg: viewBox=24, flexible-size, theme-color这类脚本适合放进资源仓库的提交检查中,但它只能验证约定明确的静态规则,不能替代视觉审查。例如光学居中、曲线是否变形、描边是否在不同缩放下显得过重,仍要回到真实组件尺寸中确认。
交付时保留可追溯性
最终资源应做到“一图标一文件、一名称一语义”。如果同一个含义存在线性版、填充版或不同尺寸专版,用团队约定的后缀区分,并在设计系统中记录对应关系。不要把 final、new、v2 这类临时状态写进长期文件名。
交付完成后,用开发侧实际加载方式打开 SVG,检查缩放、主题色和边界是否符合预期。只要源文件的坐标系、颜色控制权和命名稳定,后续无论封装成 React、Vue 组件还是图标包,都能减少二次清理和视觉偏差。