CSSのcontrast-color()で文字色を白か黒にする方法
CSS の contrast-color() に背景色を渡すと、その背景とのコントラストが大きいほう、白(white)か黒(black)が返ります。ユーザーが色を選べるタグやラベル、テーマカラーを変えられるボタンのように、背景色が前もって決まらない場面で、文字の色を JavaScript で計算せずに決められます。
検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、ヘッドレスの Chromium 153 です。結果は getComputedStyle() で読んだ計算値で、コントラスト比は WCAG 2.1 の式で私が計算しました。Firefox と Safari、対応していない古いブラウザーでの表示、スマートフォンの実機は試していません。

背景色と同じ値を渡す
contrast-color() は、要素の背景を自分で読み取るわけではありません。引数に渡した色を背景だとみなして、白か黒を返します。そのため、背景色をカスタムプロパティに入れて、background-color と contrast-color() の両方に同じ値を渡すのが基本の書き方です。
.tag {
--bg: #0b3d91;
background-color: var(--bg);
color: contrast-color(var(--bg));
}
検証環境では、--bg が #0b3d91(紺)のとき文字の色の計算値は rgb(255, 255, 255)(白)、#ffcc00(黄)のとき rgb(0, 0, 0)(黒)でした。lightblue のような色の名前や、oklch() で書いた色(oklch(0.9 0.1 90))を渡しても、結果は白か黒のどちらかでした。
背景色を変えるときは、--bg だけを書き換えます。.tag:hover { --bg: #ffcc00; } と書いたボタンにマウスを乗せると、背景は黄になり、文字は白から黒に変わりました。JavaScript で element.style.setProperty('--bg', 色) と書き換えても同じです。

color だけでなく、background-color や border-color など、色を書けるプロパティならどこにでも書けます。検証環境では background-color: contrast-color(#ffcc00) の計算値は黒でした。
白と黒のどちらが選ばれるか
CSS Color 5 の仕様では、contrast-color() は、渡した色を背景にしたときにコントラストが大きくなるほうの white か black になります。両方が同じなら white です。どの計算方法でコントラストを比べるかは、ブラウザーに任されています。
検証環境で、いくつかの色について結果と、WCAG 2.1 の式で計算したコントラスト比を並べました。
| 背景色 | 結果 | 白とのコントラスト比 | 黒とのコントラスト比 |
|---|---|---|---|
#ffffff(白) |
黒 | 1.00:1 | 21.00:1 |
#ffcc00(黄) |
黒 | 1.51:1 | 13.89:1 |
#ff0000(赤) |
黒 | 4.00:1 | 5.25:1 |
#2277d3(青) |
黒 | 4.52:1 | 4.65:1 |
#008000(緑) |
白 | 5.14:1 | 4.09:1 |
#0b3d91(紺) |
白 | 10.04:1 | 2.09:1 |
どの色でも、WCAG 2.1 のコントラスト比が大きいほうが選ばれていました。灰色を #000000 から #ffffff まで256段階で変えると、#757575 までは白、#767676 からは黒になりました。#767676 では白が 4.54:1、黒が 4.62:1 で、ここで比の大小が入れ替わります。色相を1度ずつ変えた360色(hsl(0〜359 100% 50%))でも、比の大きいほうと違う結果になった色はありませんでした。
赤の #ff0000 で黒が選ばれるのは、意外に感じるかもしれません。白い文字の比は 4.00:1 で、黒の 5.25:1 より小さいためです。デザインの都合で「赤には白い文字」と決めているなら、contrast-color() に任せず、色を直接書きます。
中間の明るさの背景色に注意する
灰色の256段階のどれでも、選ばれたほうのコントラスト比は 4.5:1 以上でした。WCAG 2.1 の達成基準 1.4.3が普通の大きさの文字に求める 4.5:1 には、数値の上では届いています。なお仕様は、白か黒かを WCAG 2.1 の式だけで選ぶことは勧めていません。ただし、返す色は大きい文字の基準(3:1)を満たすべきだとしています。白と黒のうち WCAG 2.1 の比が大きいほうが選ばれたのは、検証した Chromium 153 での結果です。
それでも、表の #2277d3 のように、白でも黒でも 4.5:1 ぎりぎりの色があります。MDN の contrast-color() のページは、この #2277d3 を例に挙げて、黒い文字になり、小さな文字では読み取れないと注意しています。そのうえで、contrast-color() に渡す色は明るい色か暗い色にすることを勧めています。仕様にも、コントラストが十分でも、フォントや文字の大きさ、周りの色によっては読みやすいとは限らないという注記があります。
contrast-color() は「白と黒のうち、ましなほう」を返すだけです。背景色の候補を自分で決められるなら、中間の明るさの色は候補から外すか、文字を大きく太くします。
半透明の色を渡すと、白い文字が返る
contrast-color() は、渡した色をそのまま背景だとみなします。下に何が重なっているかは見ません。検証環境では、contrast-color(rgb(0 0 0 / 0.2)) も contrast-color(transparent) も白でした。白いページの上に background-color: rgb(0 0 0 / 0.2) の要素を描くと、背景は画面上で rgb(204, 204, 204) の薄い灰色になりました。それでも文字は白で、この灰色と白のコントラスト比は 1.61:1 です。
仕様でも、contrast-color() は渡した色を一色で塗った背景(solid background)の上に置く文字のための関数として書かれています。半透明の背景を使う場合は、下の色と重ねたあとの見た目の色を自分で決めて、その色を渡します。
ほかの色の関数と組み合わせる
contrast-color() の結果は普通の色として扱えます。真っ白や真っ黒が強すぎるときは、相対色の書き方で透明度を足したり、color-mix() で背景色を少し混ぜたりできます。
.tag {
--bg: #0b3d91;
background-color: var(--bg);
/* 白か黒を、背景色と 15% 混ぜる */
color: color-mix(in srgb, contrast-color(var(--bg)) 85%, var(--bg));
}
検証環境では、rgb(from contrast-color(#0b3d91) r g b / 0.8) の計算値は color(srgb 1 1 1 / 0.8)、color-mix(in srgb, contrast-color(#0b3d91) 85%, #0b3d91) は color(srgb 0.856471 0.885882 0.935294) でした。上のコードのように var(--bg) を使って書いても、計算値は同じでした。紺の背景とのコントラスト比は、白のままなら 10.04:1、白を85%にすると 7.70:1、70%にすると 5.75:1 で、背景色を混ぜるほど下がります。混ぜる割合は控えめにします。
引数は色を1つだけ書きます。contrast-color(white black)、contrast-color(#ffcc00, max)、contrast-color() は、どれも無効な値として宣言ごと捨てられました。
transition を付けると、途中で灰色の文字になる
背景色の変化に transition を付けると、文字の色も白と黒のあいだで少しずつ変わります。transition: color 1s linear, background-color 1s linear を付けた要素で、--bg を紺(#0b3d91)から黄(#ffcc00)に変えたときの計算値は次のとおりでした。
| 変えてからの時間 | 背景色 | 文字の色 | コントラスト比 |
|---|---|---|---|
| 0ms | rgb(11, 61, 145) |
rgb(255, 255, 255) |
10.04:1 |
| 250ms | rgb(72, 97, 109) |
rgb(191, 191, 191) |
3.56:1 |
| 500ms | rgb(133, 133, 73) |
rgb(128, 128, 128) |
1.02:1 |
| 750ms | rgb(194, 168, 36) |
rgb(64, 64, 64) |
4.40:1 |
| 1000ms | rgb(255, 204, 0) |
rgb(0, 0, 0) |
13.89:1 |
半分のところでは、くすんだ黄緑の背景に灰色の文字が乗り、コントラスト比は 1.02:1 まで下がりました。背景と文字がほぼ同じ明るさなので、文字は背景に溶けて見えます。
transition を background-color だけに付けた場合は、文字は変えた瞬間に黒になり、背景だけが紺から黄へ変わりました。こちらは変えた直後がいちばん低く、紺の背景に黒い文字で 2.09:1、250ms で 3.21:1、500ms で 5.45:1 でした。どちらの書き方でも、変えてからしばらくはコントラスト比が低くなります。
対応していないブラウザーには @supports で分ける
@mdn/browser-compat-data(8.1.8)では、contrast-color() は Chrome 147、Edge 147、Firefox 146、Safari 26(iOS も 26)から対応しています。
CSS では、ブラウザーが解釈できない値の宣言は捨てられ、その前に書いた値が使われます。そこで前の行に color: #fff; を書いておく方法が思い浮かびますが、var() を含む値にはこの方法が効きません。MDN の CSS のエラー処理のページにあるとおり、var() を含む宣言は、読み込んだ時点では捨てられません。var() に値を当てはめてから無効と分かると、親から継承される値(文字の色なら親の色)が使われます。
対応していないブラウザーは手元で試せないので、Chromium が知らない関数 no-such-color() を代わりに書いて確かめました。親要素の文字の色は赤(rgb(255, 0, 0))にしています。
| CSS | 文字の色 |
|---|---|
color: #fff; color: no-such-color(#0b3d91); |
rgb(255, 255, 255)(前の行の白) |
color: #fff; color: no-such-color(var(--bg)); |
rgb(255, 0, 0)(親の赤) |
var() を含むほうは、前の行の白ではなく親の赤になりました。contrast-color(var(--bg)) も var() を含みます。MDN の説明どおりなら、対応していないブラウザーでは、紺の背景に親の文字の色が乗ります。前の行に書く方法の代わりに、@supports で分けます。
.tag {
--bg: #0b3d91;
background-color: var(--bg);
color: #fff;
}
@supports (color: contrast-color(red)) {
.tag {
color: contrast-color(var(--bg));
}
}
@supports (color: no-such-color(red)) で同じように書くと、条件に当てはまらないため中身は使われず、文字の色は白のままでした。contrast-color() に対応している Chromium 153 では中身が使われ、--bg が紺なら白、黄なら黒になりました。





