背景
色の組み合わせを決めるのが苦手です。
なので、文字色と背景色を入れるとコントラスト比と合否を出すツールを置いています。
https://hashitosystem.com/tools/contrast-checker/
先日、白背景の上の文字色を少しずつ変えて遊んでいたら、比が「4.50 : 1」と出ているのに、隣の判定が FAIL になっている色がありました。
バグかと思って焦ったのですが、計算は正しくて、ずれていたのは表示のほうでした…
そのときのメモです。
結論
#358282 を白背景に置くと、コントラスト比は 4.4998… になります。
これを toFixed(2) で表示すると「4.50」になる。
でも判定は丸める前の値で 4.5 と比べているので FAIL です。
WCAG の解説ページには、計算した比は丸めずに閾値と比べる、と書いてあります。
なので判定は今のままが正しい。
直すべきは表示で、合否の境目では切り捨てて見せるほうが誤解がない、というのが今回の結論です。
用語
WCAG(Web Content Accessibility Guidelines)は、Web をだれでも使えるようにするための W3C のガイドラインだ。
その中で、文字と背景の明るさの差を「コントラスト比」という1〜21の数値で表す。
通常サイズの文字は 4.5:1 以上で AA という基準を満たす。
コントラスト比は、2色の「相対輝度」から計算する。
相対輝度は、sRGB(Web の標準的な色空間)の R・G・B を 0〜1 の明るさに直して、人の目の感じ方で重み付けして足した値だ。
白が 1、黒が 0 になる。
ツールの計算
ツールの中身は下記です。
toRGB は #RRGGBB の文字列を [r, g, b](各0〜255)の配列にする関数で、入力欄が変わるたびに render() から呼ばれます。
function lin(c){c=c/255;return c<=0.03928?c/12.92:Math.pow((c+0.055)/1.055,2.4);}
function lum(rgb){return 0.2126*lin(rgb[0])+0.7152*lin(rgb[1])+0.0722*lin(rgb[2]);}
function ratio(a,b){var l1=lum(a),l2=lum(b);var hi=Math.max(l1,l2),lo=Math.min(l1,l2);return (hi+0.05)/(lo+0.05);}
// render() の中
var r=ratio(fg,bg);
$('ratio').textContent=r.toFixed(2)+' : 1';
mark($('aaN'),r>=4.5,'AA 通常テキスト (4.5:1)');
lin がガンマを外して明るさに直す部分、lum が相対輝度、ratio がコントラスト比です。
表示は toFixed(2) で四捨五入、判定は丸めない r を使っている。
この2つが同じ値を見ていないのが、今回のずれの原因でした。
何色あるのか数えてみた
気になったので、白背景に対して 256×256×256 の全色を Node.js(v24.11.1)で総当たりしました。
上の lin / lum / ratio をそのまま使い、比が 4.495 以上 4.5 未満の色を数えています。
const W = [255, 255, 255];
let hits = 0;
for (let r = 0; r < 256; r++)
for (let g = 0; g < 256; g++)
for (let b = 0; b < 256; b++) {
const x = ratio([r, g, b], W);
if (x >= 4.495 && x < 4.5) hits++;
}
console.log(hits);
結果は 9,074 色でした。
この9千色ほどは、どれも「4.50 : 1」と表示されて、AA は FAIL になります。
いくつか実際の値を挙げると下記です。
#358282 4.499899720370805 -> 4.50
#478080 4.49939924902953 -> 4.50
#6464f4 4.4957633846343885 -> 4.50
#777777 4.478089453577214 -> 4.48
#767676 4.542224959605253 -> 4.54
よく「白背景のグレーは #767676 までなら OK」と言われるのは、#777777 が 4.48 で落ちるからだと思います。
グレーは境目をまたぐので混乱しませんが、青緑や青紫だと 4.50 の FAIL に当たりやすい様子です。
なぜ丸めずに比べるのか
W3C の解説ページ(Understanding SC 1.4.3)に、丸めないこと、4.499:1 は 4.5:1 を満たさないことが例付きで書いてあります。
https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html
閾値を「4.5 以上」と決めた以上、丸めを許すと実質の境目がツールごとに 4.495 や 4.45 に動いてしまう。
判定を厳密にしておけば、どのツールで測っても同じ色が同じ結果になる。
なので、判定側を丸めた値に合わせるのは違う、と思いました。
ついでに: 0.03928 と 0.04045
lin の中の 0.03928 は、WCAG 2.0 の頃の値です。
同じ解説ページの注記に、2021年5月より前は 0.03928 で、今の定義は 0.04045(sRGB の仕様と同じ値)になった、実用上の影響は無い、とあります。
本当に影響が無いのか、0〜255 の各値で両方の閾値の lin を比べたら、違う結果になる値は 0 個でした。
c=10 は 10/255 = 0.0392… で両方の閾値より下、c=11 は 0.0431… で両方より上なので、8bit の色ではその間に入る値が無いからです。
ツールの 0.03928 はこのまま残しても結果は変わりません(直すなら見た目のためだけ)。
ツールで直すこと
表示を切り捨てにして、判定と向きを揃えます。
Math.floor(r * 100) / 100 を toFixed(2) すれば、4.4998 は「4.49」と出る。
これなら「4.50 なのに FAIL」は起きませんし、PASS の色が FAIL っぽく見えることもない。
みなさんも、コントラスト比を表示するツールを作るときは、表示を切り捨てにして判定と同じ向きに揃えてください。
本記事はAI補助で執筆した、個人開発の紹介記事です。