Colorable色彩组合对比度测试仪
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 传递,以删除重复项。
评论