UI 视觉设计 / 系统课时

拆分组件默认值与状态变量

拆分组件默认值与状态变量

一个主按钮会在默认、悬停、按下、禁用和键盘聚焦时切换外观。如果背景、文字与边框的颜色散落在组件样式里,改品牌色或加深色主题就容易漏改。本篇用一张状态矩阵确定视觉契约,再把共享语义与 Button 专属值拆成可发布的 Token。

学习目标

  • 列清 Button 的背景、文字、边框与焦点环在各状态下的取值。
  • 判断哪些状态色复用全局语义 Token,哪些保留在组件层。
  • 编写符合 DTCG 数据结构的别名,并按状态验证引用结果。

先列状态矩阵,再决定变量数量

以高度 40px、边框宽 1px 的 Primary Button 为例,先固定四种互斥状态;颜色是教学用的一套浅色主题取值,实际项目应按品牌及对比度测试调整。

状态 背景 文字 边框
默认 #175CD3 #FFFFFF #175CD3
悬停 #1849A9 #FFFFFF #1849A9
按下 #194185 #FFFFFF #194185
禁用 #EAECF0 #667085 #EAECF0

键盘焦点不是第五套背景色:保留当前可交互状态的背景、文字和边框,只增加 2px 的 #2563EB 外轮廓,轮廓与按钮相距 2px。用 :focus-visible 显示焦点环;禁用时不应再叠加悬停或按下效果。

按复用范围分开语义层和组件层

跨 Button、Tab、工具栏动作共用的含义放语义层,例如 semantic.action.primary.default、semantic.action.primary.hover、semantic.action.onPrimary。禁用底色、禁用文字和焦点环也能复用,分别命名为 semantic.disabled.surface、semantic.disabled.text、semantic.focus.ring。

若深色按下态只属于 Button,就先由 component.button.primary.background.pressed 引用基础色 palette.brand.800,不要为了名称对称而强行建立全局 pressed 语义。圆角 8px、焦点环宽 2px 和偏移 2px 是 Button 的呈现规则,放在组件层。边框颜色跟随对应背景,使用组件内部别名,避免两处手工改值。

Button 状态变量在基础层、语义层与组件层之间的引用关系

用 DTCG 别名落实拆分

下面是可以保存为 tokens.json 的完整示例。颜色采用 DTCG 的 srgb 归一化分量;$value 中的 {路径} 表示引用整个 Token。组件只保存职责和状态,不直接复制默认态的颜色值。

json
{
  "palette": {
    "$type": "color",
    "brand": {
      "600": {"$value": {"colorSpace": "srgb", "components": [0.0902, 0.3608, 0.8275]}},
      "700": {"$value": {"colorSpace": "srgb", "components": [0.0941, 0.2863, 0.6627]}},
      "800": {"$value": {"colorSpace": "srgb", "components": [0.0980, 0.2549, 0.5216]}}
    },
    "neutral": {
      "0": {"$value": {"colorSpace": "srgb", "components": [1, 1, 1]}},
      "200": {"$value": {"colorSpace": "srgb", "components": [0.9176, 0.9255, 0.9412]}},
      "500": {"$value": {"colorSpace": "srgb", "components": [0.4, 0.4392, 0.5216]}}
    },
    "focus": {"$value": {"colorSpace": "srgb", "components": [0.1451, 0.3882, 0.9216]}}
  },
  "semantic": {
    "action": {
      "primary": {
        "default": {"$value": "{palette.brand.600}"},
        "hover": {"$value": "{palette.brand.700}"}
      },
      "onPrimary": {"$value": "{palette.neutral.0}"}
    },
    "disabled": {
      "surface": {"$value": "{palette.neutral.200}"},
      "text": {"$value": "{palette.neutral.500}"}
    },
    "focus": {"ring": {"$value": "{palette.focus}"}}
  },
  "component": {
    "button": {
      "radius": {"$type": "dimension", "$value": {"value": 8, "unit": "px"}},
      "primary": {
        "background": {
          "default": {"$value": "{semantic.action.primary.default}"},
          "hover": {"$value": "{semantic.action.primary.hover}"},
          "pressed": {"$value": "{palette.brand.800}"},
          "disabled": {"$value": "{semantic.disabled.surface}"}
        },
        "foreground": {
          "default": {"$value": "{semantic.action.onPrimary}"},
          "disabled": {"$value": "{semantic.disabled.text}"}
        },
        "border": {
          "default": {"$value": "{component.button.primary.background.default}"},
          "hover": {"$value": "{component.button.primary.background.hover}"},
          "pressed": {"$value": "{component.button.primary.background.pressed}"},
          "disabled": {"$value": "{component.button.primary.background.disabled}"}
        },
        "focusRing": {
          "color": {"$value": "{semantic.focus.ring}"},
          "width": {"$type": "dimension", "$value": {"value": 2, "unit": "px"}},
          "offset": {"$type": "dimension", "$value": {"value": 2, "unit": "px"}}
        }
      }
    }
  }
}

此文件描述设计值与引用,并不自动实现鼠标或键盘交互。构建工具需要先解析别名,再按项目约定导出 CSS 变量;具体导出的变量名不是 DTCG 规范固定的。注意 $type 在 palette 组中继承,而别名 Token 的类型由目标 Token 推导。

在真实按钮上核对状态优先级

  1. 让正常态绑定 component.button.primary.background.default、foreground.default 和 border.default;交互逻辑分别将 :hover、:active 映射到 hover、pressed,禁用态映射到 disabled。
  2. 鼠标悬停应看到约 #1849A9,按住鼠标应看到约 #194185;给按钮设置 disabled 后,即使鼠标经过也应保持 #EAECF0 背景和 #667085 文字,且不能触发点击处理。
  3. 用 Tab 聚焦可用按钮,应出现 2px 焦点轮廓和 2px 间距;焦点轮廓不应覆盖背景或替代边框。浏览器开发者工具的 Computed 面板可核对最终颜色及 outline 属性。
  4. 将 palette.brand.600 改成另一个值并重新构建:默认背景、默认边框应同步改变;按下态仍引用 palette.brand.800,说明组件专属状态与共享默认语义已正确拆分。

如果后来 Input、Tab 等也需要相同的按下反馈,再将该颜色提升为 semantic.action.primary.pressed,并让各组件改用别名。是否提升由语义复用决定,不以多个值偶然相同为依据。

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

目录与阅读设置

阅读设置

17

记录一个想法

拆分组件默认值与状态变量

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

登录哪都通