UI 视觉设计 / 系统课时

规划图标命名与版本变更

规划图标命名与版本变更

图标系统长期维护的难点通常不是新增一个图标,而是旧名称已经被大量页面引用之后如何继续演进。本篇建立稳定命名、废弃、替换和删除规则,并用可追踪的资产清单记录兼容关系,让设计稿、代码和文档能够在版本变化中逐步迁移。

学习目标

  • 为图标建立稳定、可搜索且不依赖具体页面的命名规则
  • 区分新增、替换、废弃和删除四类版本动作
  • 用版本清单和迁移窗口降低重命名带来的破坏性影响

命名先表达语义再表达外观

图标名称首先应该回答“它表达什么”,而不是“它长什么颜色、放在哪个页面”。例如搜索图标可以命名为 search,而不是 header-magnifier-gray。前者能跨导航、弹窗和表格复用;后者一旦换位置、换主题或重新绘制就会失去意义。

不稳定命名 更稳定的命名 问题所在
home-header-search search 把使用页面写进资产身份
arrow-blue arrow-right 把主题颜色写进名称
new-delete-icon trash 或团队约定的 delete 用临时状态描述长期资产
icon-24-edit edit 把展示尺寸和语义混在一起

同一系统还要固定词形,例如动作统一使用动词,实体统一使用名词,并提前确定同义词的唯一写法。trash 和 delete 都合理,但如果两者同时存在却表示同一图标,搜索、调用和迁移都会变得困难。

把图标变更当成一个生命周期

一个公开图标通常不会从“正在使用”直接跳到“删除”。更安全的过程是先引入新名称或新图形,让旧入口进入废弃状态并指向替代项,留出迁移窗口后,再在明确的大版本或约定的破坏性发布中删除旧入口。

图标从新增到废弃和删除的版本生命周期

新增图标通常只扩展能力;替换意味着新资产承担旧资产的语义;废弃表示旧入口暂时仍可用,但不应继续产生新调用;删除才会真正让旧名称失效。把这四个动作分开记录,可以避免“设计稿已经改名,但代码包当天就找不到旧图标”的断裂。

用资产清单记录兼容关系

仅靠聊天记录或发布说明很难维护几十甚至几百个图标。可以给图标仓库增加一份机器可读清单,记录状态、引入版本以及替代关系。下面是配置片段示例,字段名称可按团队工具链调整,但同一仓库应保持结构稳定。

json
{
  "schemaVersion": 1,
  "icons": {
    "search": {
      "status": "active",
      "introduced": "2.0.0"
    },
    "magnifier": {
      "status": "deprecated",
      "introduced": "1.0.0",
      "deprecated": "2.0.0",
      "replacement": "search",
      "removeAfter": "3.0.0"
    }
  }
}

这份清单的生效行为应由构建或检查工具定义:active 项可以正常被新代码引用,deprecated 项继续兼容但产生迁移提示,replacement 指向可替换名称。验证时至少检查名称唯一、替代项真实存在,以及已经删除的名称不会继续出现在导出入口中。

让版本号表达影响范围

如果图标包对外承诺遵循语义化版本,可以按“调用方是否必须修改”判断版本级别。新增图标通常可以进入次版本;保留旧入口的废弃标记也可以作为兼容性变更发布;删除旧名称、修改导出名称或改变既有属性契约,则应留到明确的破坏性版本。

单纯优化矢量节点并不一定需要大版本,但要判断它是否改变了已经承诺的视觉语义。例如把“下载”改画成“上传”虽然文件名和调用方式没变,实际含义已经改变,不能当作普通修图静默发布。图标系统的兼容性既包括 API,也包括用户最终看到的语义。

给重命名保留迁移窗口

实际重命名时,优先采用渐进迁移,而不是一次性替换所有入口。先增加新名称,再让旧名称成为别名或兼容导出,同时在文档和资产清单中标记废弃。随后扫描产品中的旧调用,把业务代码和设计稿逐步迁移到新名称,最后才在约定版本移除兼容入口。

迁移期间应避免同时修改名称、视觉含义和调用接口,否则出现问题时很难判断是哪一层变化造成的。稳定的版本策略不是永远不改图标,而是让每一次改动都能回答三个问题:旧调用还能使用多久、应该迁移到哪里,以及从哪个版本开始旧入口会真正失效。

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

目录与阅读设置

记录一个想法

规划图标命名与版本变更

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

登录哪都通