SuperAPI AI 工具集

color

设计与创作

查看项目

更新于 11-06 16:14

技能介绍

用途:该技能定义适用于所有屏幕的颜色规则,用于统一检查与约束对比度、角色令牌、半透明中性色、深色模式和强调色用途。

主要能力:

  1. 对比度要求:对比度按屏幕实际绘制的颜色精确测量,不能根据令牌名称猜测;每个主题和每种表面都要读取。小于24px的正文,或小于18.66px的粗体文本,对比度需达到4.5:1;更大文本达到3:1。占位符和次要文本计入,禁用控件不计。表单边缘、开关轨道和承载含义的图标需达到3:1;分隔线和浮动表面的环属于装饰,可豁免。
  2. 合成测量:半透明颜色和不透明度需与其后所有图层合成后再读取比值;例如文本处于 opacity: 0.6 时,不能按令牌十六进制值计算。可在页面中通过浏览器 evaluate 调用运行 contrast.js,将结果视为候选,并在放大裁切图中确认后再报告。
  3. 图片上的文本:照片或视频上的文本需置于渐变遮罩或实色底板上,比值按文本下方图像最亮点判断。
  4. 角色令牌:组件引用按角色命名的令牌,如 --text-secondary 或 --surface-raised;只有主题文件把角色映射到调色板步骤,组件内不得直接使用 color: var(--gray-500)。
  5. 半透明中性色:边框、分隔线、悬停填充和按下填充使用带透明度的中性色,以便在任何底层表面上都可读。
  6. 深色模式:深色表面通过变亮来提升层级,因为阴影在深色页面上几乎不可见;强调色和状态色使用为对比度调校过的深色值。
  7. 强调色与状态色:强调色标记主操作、选中和焦点;每种状态色保持单一含义,红色仅用于错误和破坏性操作。

使用方式:资料提供了一组“规则—错误示例—替代写法”的配对,例如正文 #999 在白底为2.8:1,应改为 #737373(4.7:1);仅以 #e5e5e5 为边缘的输入框在白底为1.3:1,应改为 border-color: #8a8a8a(3.5:1);组件内使用调色板步骤应改为角色令牌;悬停实色中性色应改为 var(--gray-a3);深色弹层仅靠阴影抬升应改为比页面更亮的表面;浅色强调色复用到深色模式应改用深色调校值。

报告与分级:HIGH 包括主表面上正文对比度不达标、表单边缘低于3:1、图片上文本无遮罩;MEDIUM 包括组件内使用调色板步骤、实色中性色在表面上消失、比值未在屏幕上读取、深色表面仅靠阴影抬升、浅色强调色复用于深色模式;LOW 包括强调色用于装饰、状态色承载第二含义。每个根因输出一条 file:line - [rule-id] 发现(含测量比值),并给出 Rule | Count | Severity 汇总;存在任何 HIGH 时阻断,否则放行;未打开过的主题不得放行;画布、视频和跨源框架上的文本标记为未验证。

适用场景:界面颜色规范审查、主题与组件颜色实现检查、深色模式适配、对比度问题排查。

限制:资料未说明该技能的安装方式、依赖环境或具体运行命令;contrast.js 的获取与调用细节暂未提供。