Colorable色彩组合对比度测试仪

联合创作 · 2023-10-01 19:53

Colorable 提供一组调色板,你可以为每一个色彩组合获取合适的对比度值(包含 WCAG 可访问性指南的及格/不及格分数),让你的网页可访问性不出现色彩对比度问题。

用法

传递颜色字符串数组,或带有颜色字符串的对象作为值

var  colorable  =  require ( 'colorable' ) 

var  colours  =  { 
  red : 'red' , 
  green : 'green' , 
  blue : 'blue' 
} 

var  result  =  colorable ( colors ,  {  compact : true ,  threshold : 0  } )

返回一个颜色数组,其中包含所有其他颜色及其 WCAG 对比度值的组合。

[
  {
    "hex": "#FF0000",
    "name": "red",
    "combinations": [
      {
        "hex": "#008000",
        "name": "green",
        "contrast": 1.28483997166146,
        "accessibility": {
          "aa": false,
          "aaLarge": false,
          "aaa": false,
          "aaaLarge": false
        }
      },
      {
        "hex": "#0000FF",
        "name": "blue",
        "contrast": 2.148936170212766,
        "accessibility": {
          "aa": false,
          "aaLarge": false,
          "aaa": false,
          "aaaLarge": false
        }
      }
    ]
  },
  ...
]

可访问对象

每个键都是一个布尔值,表示颜色对比度是否满足以下条件:

  • aa - 大于4.5 (适用于正常大小的文本)
  • aaLarge - 大于3 (粗体或大于 24 px 的文本)
  • aaa - 大于 7
  • aaaLarge - 大于 4.5

选项

compact

类型:Boolean(默认:false

如果设置为true,则结果将是一个较小的对象,该对象仅包含十六进制值颜色字符串、每种颜色的名称(如果将对象传递给函数)、对比度和可访问性值。设置为 false,则结果还包括每种颜色的整个 harthur/color 对象,其中包括用于颜色操作的其他属性和方法。

threshold

类型:数值(默认值:0

设置后,可着色函数仅返回对比度高于此值的组合。适用于只查看比最低对比度级别高的颜色组合。

uniq

类型:布尔值(默认值:true)

设置为true,颜色数组通过 lodash.uniq 传递,以删除重复项。

 

浏览 4
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报