Lighthouseで文字と背景のコントラスト不足を直す方法

​​Lighthouse​CSS,WCAG,アクセシビリティ,トラブルシュート

Lighthouse のアクセシビリティの監査で「Background and foreground colors do not have a sufficient contrast ratio.」(日本語のレポートでは「背景色と前景色には十分なコントラスト比がありません」)と出たときは、文字の色と背景の色の差が足りない要素があります。レポートには要素ごとに、いまのコントラスト比と、必要な比(4.5:1 か 3:1)が出ます。その差が埋まるまで文字色か背景色を濃く(または薄く)すれば、指摘は消えます。サイトの日付や注記を薄い灰色にしたときや、明るい色のボタンに白い文字を載せたときに出やすい指摘です。

私は検証環境で、薄い灰色の文字と水色のボタンを置いたページに Lighthouse を実行し、指摘が出ることと、色を直すと消えることを確かめました。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Lighthouse 13.6.0(npm で入れた CLI。中で使われている axe-core は 4.14.0)、ブラウザは Google Chrome for Testing 153 のヘッドレスです。アクセシビリティの項目だけ(--only-categories=accessibility)を、初期設定のモバイル向けの条件で実行しました。ページは手元で作り、127.0.0.1 から配信しました。axe-core の直接実行とスクリーンショットには Playwright 1.63.0 を使いました。Chrome の DevTools の Lighthouse パネルや PageSpeed Insights、背景に画像やグラデーションを使った文字の直し方、ダークモードの配色は試していません。

指摘が出るページ

検証に使ったのは、次のページです。同じ灰色(#949494)の文字を 24px と 16px で1つずつ置き、日付の注記をさらに薄い #999999 に、ボタンを水色(#00c8e8)の背景に白い文字にしています。

html
<style>
  .note { color: #999999; font-size: 14px; }
  .lead { color: #949494; font-size: 24px; }
  .small { color: #949494; font-size: 16px; }
  .btn { color: #ffffff; background: #00c8e8; border: 0; padding: 8px 16px; font-size: 16px; }
</style>

<h1>猫の手帳</h1>
<p class="lead">今週のおすすめ</p>
<p class="small">今週のおすすめ</p>
<p class="note">最終更新:2026年11月13日</p>
<button class="btn" type="button">登録する</button>

コードは style の中の一部と main の中だけを抜き出しています(ほかのページの例も同じです)。body の背景は白(#ffffff)です。このページを python3 -m http.server 8000 --bind 127.0.0.1 --directory site で配信し、次のように Lighthouse を実行しました。

bash
npx lighthouse http://127.0.0.1:8000/bad.html \
  --only-categories=accessibility \
  --output=json --output=html --output-path=./out/bad \
  --chrome-flags="--headless=new --no-sandbox" --quiet

HTML のレポートでこの指摘を開くと、「Failing Elements」に3つの要素が並びました。24px の「今週のおすすめ」は入っていません。

Lighthouse のレポートで「Background and foreground colors do not have a sufficient contrast ratio.」を開いた画面。Failing Elements に p.small の「今週のおすすめ」、p.note の「最終更新:2026年11月13日」、button の「登録する」の3つが、ページの縮小画像と一緒に並んでいる
直す前のページのレポート。指摘された3つの要素が並ぶ

レポートの数字の読み方

HTML のレポートの一覧には、どの数値が足りないかまでは出ません。JSON のレポートには、要素ごとに説明の文が入っています。これを小さな Node.js のスクリプトで取り出すと、次のとおりです。以下の accessibility score: などの行は、このスクリプトが付けた見出しです(Lighthouse のバージョンや点数の内訳などの行は省いています)。

text
accessibility score: 90
color-contrast title: Background and foreground colors do not have a sufficient contrast ratio.
color-contrast score: 0 (binary)
- body > main > p.small | <p class="small"> | 今週のおすすめ
   Fix any of the following:
     Element has insufficient color contrast of 3.03 (foreground color: #949494, background color: #ffffff, font size: 12.0pt (16px), font weight: normal). Expected contrast ratio of 4.5:1
- body > main > p.note | <p class="note"> | 最終更新:2026年11月13日
   Fix any of the following:
     Element has insufficient color contrast of 2.84 (foreground color: #999999, background color: #ffffff, font size: 10.5pt (14px), font weight: normal). Expected contrast ratio of 4.5:1
- body > main > button.btn | <button class="btn" type="button"> | 登録する
   Fix any of the following:
     Element has insufficient color contrast of 2.01 (foreground color: #ffffff, background color: #00c8e8, font size: 12.0pt (16px), font weight: normal). Expected contrast ratio of 4.5:1
failed accessibility audits: color-contrast

1つの要素について読むところは4つです。

  • contrast of 3.03:いまのコントラスト比
  • foreground color と background color:比を計算した文字色と背景色
  • font size と font weight:必要な比を決めるのに使った文字の大きさと太さ
  • Expected contrast ratio of 4.5:1:合格に必要な比

.lead(24px)と .small(16px)は同じ #949494 なのに、24px のほうは合格し、16px のほうだけが指摘されました。必要な比が、文字の大きさで変わるためです。この点は後の節で確かめます。

日本語のレポート(--locale=ja)にしても、監査名は日本語になりましたが、要素ごとの説明の文は英語のままでした。

文字色と背景色を濃くして直す

直し方は、文字色か背景色を変えて、比を「Expected contrast ratio」の値以上にすることです。この例では、灰色の文字を #767676 に、ボタンの背景を濃い水色の #067a98 に変えました。

css
.note { color: #767676; font-size: 14px; }
.small { color: #767676; font-size: 16px; }
.btn { color: #ffffff; background: #067a98; border: 0; padding: 8px 16px; font-size: 16px; }

24px の .lead は合格していたので、#949494 のまま残しました。同じ条件で Lighthouse を実行し直すと、指摘は消え、点数は100になりました(点数の内訳などの行は省いています)。

text
accessibility score: 100
color-contrast title: Background and foreground colors have a sufficient contrast ratio
color-contrast score: 1 (binary)
failed accessibility audits: (none)

合格した要素の比は、Lighthouse のレポートには出ません。そこで、Lighthouse と同じ axe-core 4.14.0 を Playwright でページに読み込んで直接実行し、合格した要素の比も書き出しました。

text
--- good.html
passes: h1 | ratio=14.66 fg=#1f2a30 bg=#ffffff size=24.0pt (32px) weight=bold expected=3:1
passes: .lead | ratio=3.03 fg=#949494 bg=#ffffff size=18.0pt (24px) weight=normal expected=3:1
passes: .small | ratio=4.54 fg=#767676 bg=#ffffff size=12.0pt (16px) weight=normal expected=4.5:1
passes: .note | ratio=4.54 fg=#767676 bg=#ffffff size=10.5pt (14px) weight=normal expected=4.5:1
passes: button | ratio=4.94 fg=#ffffff bg=#067a98 size=12.0pt (16px) weight=normal expected=4.5:1

白い背景に #767676 の文字は 4.54:1 で、4.5:1 をわずかに上回ります。白い文字を載せたボタンは、背景を #067a98 にすると 4.94:1 になりました。

直す前と直した後のページを縦に並べたスクリーンショット。直す前は、16px の「今週のおすすめ」と日付が薄い灰色で、「登録する」のボタンは明るい水色に白い文字。直した後は、その2行が少し濃い灰色になり、ボタンは濃い水色に白い文字になっている。24px の「今週のおすすめ」は、どちらも同じ灰色のまま
直す前(上)と直した後(下)のページ。指摘された3か所だけ色を変えた

ボタンのように白い文字を残したいときは背景を濃くし、背景を変えられないときは文字色を濃くします。どちらを変えても、比が必要な値に届けば指摘は消えます。

大きな文字は 3:1 で合格する

必要な比は、通常の文字が 4.5:1、大きな文字が 3:1 です。axe-core 4.14.0 の判定の設定では、18pt 以上、または太字(font-weight が700以上)で 14pt 以上を大きな文字として扱います。px に直すと、18pt は 24px、14pt は約18.67px です。このルールには、WCAG の達成基準 1.4.3 を示す wcag143 のタグが付いています。

太字の境目も、別のページで確かめました。同じ #949494 の太字を、18px と 19px で置いたページです。

html
<style>
  .bold18 { color: #949494; font-size: 18px; font-weight: bold; }
  .bold19 { color: #949494; font-size: 19px; font-weight: bold; }
</style>

<p class="bold18">太字18pxの見出し風の文字</p>
<p class="bold19">太字19pxの見出し風の文字</p>

axe-core を直接実行した結果は次のとおりで、比はどちらも 3.03 ですが、必要な比が分かれました(ほかの要素の行は省いています)。

text
violations: .bold18 | ratio=3.03 fg=#949494 bg=#ffffff size=13.5pt (18px) weight=bold expected=4.5:1
passes: .bold19 | ratio=3.03 fg=#949494 bg=#ffffff size=14.3pt (19px) weight=bold expected=3:1

Lighthouse のレポートでも、2つの太字のうち指摘されたのは 18px のほうだけでした。文字を少し大きくしたり太くしたりして、3:1 で合格する側に入れる直し方もあります。

opacity で薄くした文字も指摘される

文字色そのものは濃くても、opacity で要素ごと薄くしていると指摘されます。color: #1f2a30 に opacity: 0.4 を付けた段落を置きました。

html
<style>
  .faded { color: #1f2a30; opacity: 0.4; }
</style>

<p class="faded">opacity で薄くした文字</p>

Lighthouse の結果は次のとおりです。

text
- body > main > p.faded | <p class="faded"> | opacity で薄くした文字
   Fix any of the following:
     Element has insufficient color contrast of 2.34 (foreground color: #a5aaac, background color: #ffffff, font size: 12.0pt (16px), font weight: normal). Expected contrast ratio of 4.5:1

foreground color は、CSS に書いた #1f2a30 ではなく、白と混ぜた後の #a5aaac になっています。レポートの色が CSS で見当たらないときは、opacity が付いていないかを確かめます。

指摘されないまま残る文字

Lighthouse で100点になっても、すべての文字の比が足りているとは限りません。同じページに、次の2つも置きました。

html
<style>
  .hero { background-image: linear-gradient(90deg, #00c8e8, #eefafd); padding: 16px; }
  .hero p { color: #ffffff; margin: 0; }
</style>

<div class="hero"><p>グラデーションの上の白い文字</p></div>
<button type="button" disabled>送信できません</button>

グラデーションの上の白い文字は、Lighthouse の結果に出ませんでした。axe-core を直接実行すると、この要素は合格でも不合格でもなく「incomplete」(判定できない)になり、理由は bgGradient でした。axe-core のメッセージでは「Element's background color could not be determined due to a background gradient」、つまり背景がグラデーションなので背景色を決められない、という意味です。

text
incomplete: div > p | ratio=0 fg=undefined bg=undefined size=12.0pt (16px) weight=normal expected=4.5:1 messageKey=bgGradient

Lighthouse 13.6.0 の axe-core の結果を採点する処理では、点数を付ける監査は violations(違反)だけを見て、incomplete は数えません。背景画像の上の文字や、ほかの要素が重なった文字も、axe-core のメッセージの一覧では incomplete の理由になっています。こうした文字は、自分で色を確かめます。

disabled を付けたボタンは、合格・不合格・incomplete のどれにも出てきませんでした。axe-core 4.14.0 の対象を選ぶ処理で、無効になった要素は最初から対象外になっています。

点数への影響

Lighthouse 13.6.0 の初期設定(default-config.js)では、color-contrast の重みは7です。監査は違反が1つでもあれば0点になり、指摘が1か所でも3か所でも点数の下がり方は同じです。検証したページでは、重みの合計71のうち7を落として 64 / 71 となり、点数は90でした。

直した後は、点数よりも、レポートの Failing Elements が空になったかで確かめます。合格した要素は、#767676 の 4.54:1 のように基準ぎりぎりでも Lighthouse のレポートには出てこないので、比の値まで見たいときは、上のように axe-core を直接実行します。

​Posted by 86