mcpField
M
manage-color-contrast

manage-color-contrast

github.com/gnurio设计与 UI453161 次安装26 周前更新
代码仓库

关于 manage-color-contrast

用于评估和改进界面颜色对比度的设计技能,面向设计与无障碍检查。它计算对比度,并依据 WCAG AA 判断是否达标、提出修正建议。

主要功能

  1. 01计算颜色对比度
  2. 02按 WCAG AA 检查达标情况
  3. 03提供颜色调整建议

适用场景

  1. 01检查正文文字与背景的对比度
  2. 02评估按钮、输入框和焦点指示器
  3. 03修正浅色文字或低对比度品牌色

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/gnurio/refactoring-ui-plugin --skill manage-color-contrast

安装后在 Claude Code 中输入/manage-color-contrast确认已加载。

详细介绍

技能:管理颜色对比度

用途

确保文本和交互元素与背景之间有足够的对比度,以便于阅读并满足无障碍要求。

类型

评估 + 修正

输入

  • 文本颜色和字号
  • 背景颜色
  • UI 元素规格

输出

  • 对比度计算结果
  • 是否符合 WCAG 标准
  • 修复建议

执行的转换

计算对比度,并确保符合 WCAG AA 标准(普通文本为 4.5:1,大号文本和 UI 组件为 3:1)。

判定标准

通过(对比度良好)
  • 普通文本(< 18px):最低为 4.5:1(WCAG AA)
  • 大号文本(≥ 18px 且为粗体,或 ≥ 24px):最低为 3:1
  • UI 组件(按钮、输入框):边界的最低对比度为 3:1
  • 焦点指示器:与相邻颜色的最低对比度为 3:1
未通过(对比度较差)
  • 白色背景上的浅灰色文本(< 4.5:1)
  • 浅色背景上的白色文本
  • 看起来像启用状态的禁用状态(对比度过高)
  • 占位符文本与输入文本颜色相同

对比度速查表

白色背景上的文本颜色比率符合 AA?
#000000(黑色)21:1✓
#33333312.6:1✓
#6666665.9:1✓
#7575754.6:1✓(最低)
#9999992.8:1✗
#CCCCCC1.6:1✗

常见失败模式

失败情况描述修复方法
浅灰色文本正文使用 #999 或更浅的颜色至少使用 #666,优先使用 #333
幽灵文本占位符与输入值颜色相同将占位符颜色调浅(#999)
主色对比度低品牌色太浅,无法搭配白色文本加深品牌色,或改用深色文本
不明显的链接链接与文本几乎没有区别添加下划线或提高对比度
禁用状态混淆禁用按钮过于醒目将不透明度降低至 30%,或使用灰色
图标过淡图标颜色太浅,难以看清使用与文本相同的颜色,或提高对比度

前提条件

  • 已定义调色板
  • 已定义字体比例

依赖项

  • build-color-palette(需要灰度色阶)

Refactoring UI 参考

  • “不要在有色背景上使用灰色文本”
  • “确保有足够的对比度”

示例评估

输入: 白色背景上的正文颜色为 #888888

评估: 未通过

  • 比率:约 3.5:1
  • 低于 4.5:1 的要求

建议: 至少改为 #666666(5.9:1) 正文优先使用 #333333 或 #1A1A1A

评论

支持 Markdown