UI 视觉设计 / 系统课时

确定设计源与代码源的责任边界

确定设计源与代码源的责任边界

同一按钮在 Figma、Web 和 iOS 上出现差异时,团队必须先判断谁有权改变目标,再判断谁负责实现。本课以主按钮的颜色与禁用行为为例,为设计意图、令牌值、组件行为和平台适配指定唯一决策来源,并把交接与审核写成可检查的规则。

学习目标

  • 按四类变更识别设计源、代码源及其审核人。
  • 用一次令牌变更走通审批、导出、实现和验收。
  • 用可运行的检查脚本识别越权决策或缺失审核。

将四类决策交给不同责任人

“源”指遇到冲突时以哪份记录为准,不代表其他角色不能提出修改意见。以下以设计团队维护 Figma Variables、工程团队维护代码仓库的协作模式为例。

决策领域 唯一权威来源 决策人 / 必需复核人 具体例子
设计意图 Figma 组件说明和已批准变体 设计负责人 / 组件工程负责人 主按钮用于主要操作;间距为 8px
令牌语义与值 已批准的 Figma Variables 设计负责人 / 组件工程负责人 color/action/primary 为 #1D4ED8
组件行为和 API 组件源码及自动化测试 组件工程负责人 / 设计负责人 disabled 时不触发提交;键盘可激活
平台适配 各端实现仓库及测试 各端工程负责人 / 设计负责人 iOS 字体放大时按钮标签可换行

这里约定令牌值以 Figma 为源:仓库中的 tokens/semantic.json 只是经批准导出的版本化产物,不允许手改。若团队选择代码仓库作为令牌源,也可以,但必须将这一行的权威来源和审批流程整体反转,不能允许两端同时修改同一值。

设计源、审核交接与各端代码源之间的责任数据流

用主按钮改色完成一次交接

假设设计将 color/action/primary 从 #1D4ED8 调整为 #1E40AF,影响 Web 和 iOS 两端。把一次改色拆为以下可验收动作:

  1. 设计发起:在变更单填写变量名、旧值、新值、Figma 文件及版本链接、涉及的 Button 变体,并解释改色原因;不直接编辑仓库中的生成文件。
  2. 设计批准:核对默认、悬停、按下、禁用状态;白色按钮文字与背景的对比度至少达到 WCAG 普通文本 4.5:1。涉及状态设计时同步更新说明。
  3. 工程复核:确认变量名称与 Web CSS 自定义属性 --color-action-primary 的映射未改变,并检查哪些组件和端会消费该变量。
  4. 受控导出:使用团队实际配置的 Variables 导出插件或 API 流水线重新生成 tokens/semantic.json,提交 Git 变更;Figma 本身不会自动把变量写入仓库。
  5. 各端验收:Web 检查按钮实际计算样式、键盘焦点与禁用提交;iOS 检查新色和大字体布局。记录 Figma 版本与 Git 提交标识,复核完成后再合并。

如果改动的是“禁用时点击是否提交”,它属于组件行为:工程负责人修改实现及测试,设计负责人复核意图,不应通过改色令牌或 Figma 原型替代行为验证。

用脚本检查审批是否越界

可以将责任矩阵转成最小的变更单门禁。下面脚本不依赖 Figma 插件或网络,只检查变更单的决策角色和复核角色;它不会替代视觉、无障碍或行为测试。

将下面代码保存为 ownership-check.js(适用于 Node.js 18 及以上版本):

js
const policy = {
  designIntent: ["design", "engineering"],
  tokenValue: ["design", "engineering"],
  componentBehavior: ["engineering", "design"],
  platformAdaptation: ["platform", "design"],
};

const requests = [
  { id: "BTN-41", domain: "tokenValue", decisionBy: "design", approvedBy: ["engineering"] },
  { id: "BTN-42", domain: "componentBehavior", decisionBy: "design", approvedBy: ["engineering"] },
  { id: "BTN-43", domain: "platformAdaptation", decisionBy: "platform", approvedBy: ["design"] },
];

// 每一类规则依次规定决策角色与跨职能复核角色。
for (const request of requests) {
  const [owner, reviewer] = policy[request.domain] ?? [];
  // 未知领域、决策角色不符或缺少复核,均阻止合并。
  const valid = request.decisionBy === owner && request.approvedBy.includes(reviewer);
  console.log(`${request.id} ${valid ? "PASS" : "BLOCK"}`);
}

执行:

bash
node ownership-check.js

预期输出:

text
BTN-41 PASS
BTN-42 BLOCK
BTN-43 PASS

BTN-42 被阻止,因为设计角色不能单方面批准组件行为。实际接入 CI 时,应从真实变更单和审批记录读取角色,而不是保留示例中的固定数组;还需保证角色身份由受信任的审批系统提供,不能由提交人自报。

用冲突归属与验收规则防止双源

出现差异时,先查变更所属领域,再回到对应权威来源修正:

  • Figma 值正确、Web 颜色仍旧:检查导出产物和 CSS 映射;重新导出或修复构建,禁止在生成文件中手工覆盖颜色。
  • 设计稿显示禁用、点击仍提交:工程侧修复组件事件或原生禁用属性,并补回归测试;如果禁用规则本身有争议,先由设计确认交互意图。
  • 同一按钮在 iOS 上文字被截断:平台负责人检查布局和 Dynamic Type 适配;需要更改换行或高度规则时交设计复核,而不是直接修改共享令牌。

一次变更达到以下条件才能关闭:变更单有领域、决策人及跨职能复核记录;令牌导出版本可追溯到 Figma 批准版本;Web 与目标移动端的视觉和行为检查通过。若任一条缺失,保留变更单为待处理状态,不以“设计稿看起来一样”替代代码验收。

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

目录与阅读设置

阅读设置

17

记录一个想法

确定设计源与代码源的责任边界

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

登录哪都通