トピックを検索
背景とのコントラストが足りないフォーカスの枠
フォーカスの枠が隣の色に近く、白い背景では半透明の文字色が薄いグレーになり、青い帯の上ではブランドの青が埋もれてしまう
outline: 2px solid #1a4fd0 問題
弱視の利用者には、キーボードフォーカスがどのリンクやボタンにあるのか見つけられない
オンラインストアの白いヘッダーにメニューのリンクが並び、その下に「今週は送料無料」と書かれた青い帯があって、白いボタンが2つ置かれています。Tabキーで移動すると、どのリンクとボタンにもフォーカスの枠が付くので、フォーカスが消えることはありません。ただ、その枠が見えにくくなっています。よくあるのは次の2つの形です。
1つ目は、文字色を半分の濃さにした枠で、ネットショップのテーマの中にはこの書き方をしているものがあります。文字が白い帯の上では、枠は明るい青みのグレーになり、十分に目立ちます。文字が濃いグレーの白いヘッダーでは、リンクの周りの薄いグレーの細い線にしかなりません。
2つ目は、ブランドの青の枠です。ヘッダーでははっきり見えますが、帯のボタンの周りでは、枠が帯の濃い青の上に乗るため、どちらのボタンに枠があるのか、よく見ないと分かりません。
WCAG 1.4.11「非テキストのコントラスト」は、状態を識別するのに必要な視覚的な情報と隣接する色との間に、3:1以上のコントラストを求めています。フォーカス表示もこれに含まれます。コントロールの外側に描いた枠は、コントロールの周りの背景の上に乗るため、その背景に対して測ります。コントロールの内側に描いた枠は、コントロール自身の塗りに対して測ります。
- 半分の濃さの枠は
rgb(67 67 67 / 0.5)です。白いヘッダーと合成されると#a1a1a1になり、2.58:1です。文字がほぼ黒なら同じ書き方でも基準を満たすことがあるため、見過ごされがちです。枠の濃さは元の文字色で決まるので、文字色を少し淡いグレーにしただけで、枠は3:1を下回ります。 - ブランドの枠は
#1a4fd0です。白いヘッダーの上では6.83:1ですが、#12348fの帯の上では1.61:1しかありません。
どちらの枠も、確かめたのは1つの背景だけです。1つ目は後から変わった文字色に対して、2つ目はデザインしたときの白いページに対してしか確かめていません。
日差しの下で光沢のあるスマートフォンの画面を見るときや、暗いノートパソコンの画面では、誰にでも同じことが起こります。コントラストの低い枠は、真っ先に見えなくなります。
10グループ中2グループに影響
axeのようにスタイルシートを読む自動チェックは、要素にフォーカスしないため、フォーカスの枠を見ることがありません。EaseWebの監査は、ページごとに最大25個のコントロールにフォーカスし、その前後の画像を比べて、最も強い変化を元の色に対して測ります。そのため、この例の白の上の薄いグレーの枠も、帯の上の青い枠も検出できます。メニュー、ダイアログ、次のスライドなど後から現れるコントロールには届かず、ホバーのときだけ描かれる枠も測りません。デザインツールで選んだ枠やAIが書いた枠は、モックアップのページの色に対してしか確かめていないことがあります。ブランドの枠が白の上では合格し、帯の上で不合格になるのはそのためです。
修正方法
フォーカスの枠を、置かれるどの背景に対しても3:1以上にする
文字色を半分の濃さにした枠
:root { --ink: 67 67 67;}.sale-band { --ink: 255 255 255; background: #12348f;}.site-header,.sale-band { color: rgb(var(--ink));}.sale-band .button { background: #fff; color: #12348f;}:focus-visible { /* 文字色を半分の濃さで */ outline: 2px solid rgb(var(--ink) / 0.5); outline-offset: 2px;}問題点3点
- 枠の色は文字色を半透明にしたものなので、コントラストは文字の濃さ次第です。
- 白いヘッダーでは
#a1a1a1に合成され、周りの白に対して2.58:1です。 - 帯の上では
#899ac7に合成されて3.92:1になるため、問題が出るのは白の上だけです。
背景ごとの枠
:root { --ink: 67 67 67; --focus-ring: #1a4fd0;}.sale-band { --ink: 255 255 255; --focus-ring: #fff; background: #12348f;}.site-header,.sale-band { color: rgb(var(--ink));}.sale-band .button { background: #fff; color: #12348f;}:focus-visible { outline: 2px solid var(--focus-ring); outline-offset: 2px;}修正の手順3ステップ
- 半透明ではない
--focus-ringトークンを用意し、ページではブランドの青にします。白に対して6.83:1です。 - 帯の上ではトークンを白に設定し直します。
#12348fに対して10.97:1です。 - 枠をトークンで描き、それぞれの背景で確かめた色が使われるようにします。
これで2つの修正前の例はどちらも直り、ここで設定した2つの背景で1.4.11を満たします。暗いフッターや色の付いたカードなど、背景が増えるたびに、その背景用の値と確認が必要です。
このページでは、3つとも1.4.11を満たします。背景ごとの枠は、ブランドの色1色のすっきりした見た目を保てますが、コンポーネントを置く背景ごとにトークンの値と確認が必要です。2色の枠は、青か白のどちらかと十分なコントラストがある背景なら、どれにも1つのルールで対応できますが、見た目は重くなります。達成方法C40は同じ考え方をさらに進め、白とほぼ黒のように2色の差を9:1以上にして、どんな背景でもどちらかの色と十分なコントラストが取れるようにします。ボタンの内側の枠は、明るいボタンしか置かない帯に向いていて、帯用の色も要りませんが、対象はそのボタンだけです。帯の上のほかのものには、背景ごとの枠か2色の枠が必要です。コントロールを置く背景がいくつあるか、編集者が新しい背景を足せるかで選びます。
何に対して測るかは、枠がどこにあるかで決まります。outline-offset が正の値のoutlineは背景の上に乗るため、白いページに置いたブランド色のボタンには、ブランド色の枠を使えます。枠はボタンではなく、白に対して測られるからです。コントロールの縁をまたいで内側と外側の両方にかかる枠は、どちらか一方の部分で3:1あれば足ります。ヘッダーのリンクやお知らせバーの矢印のように、テーマがコントロールの内側に描く枠は、コントロールの塗りに対して測ります。
色を半分の濃さにした枠や、フレームワークがブランド色を不透明度25%で描く柔らかい光のような半透明の枠は、下の色と混ざるため、コントラストが一定しません。それぞれの背景の上で合成された後の色を測るか、枠を不透明な色にします。box-shadow だけで描いた枠も同じで、さらにコントラスト テーマで消えてしまいます。ハイコントラストモードで消えるフォーカス・アイコン・選択状態のとおり、outlineを残します。
カルーセルのトラックや、横にスクロールするカードの列など、親要素の overflow: hidden で、白い縁取りや外側の枠が欠けることがあります。コントロールの周りに余白を取るか、そこでは内側の枠を使います。ダークテーマにも専用の枠の値が必要です。ダークモードでコントラストが足りなくなる文字とアイコンで扱います。
このガイドで扱うのは、枠の色と隣接する色との関係です。枠がまったくない場合は見えないフォーカス表示、枠が細すぎて見つけにくい場合や、フォーカス前の色に近すぎる場合は、より厳しいAAAの基準として細く薄くて見つけにくいフォーカス表示で扱います。入力欄の枠、チェックボックス、アイコンはコントラストが足りない入力欄・チェックボックス・アイコンで扱います。
修正の確認
4項目、マウス不要
確認方法: コントラストの測定、キーボード、拡大表示、強制配色
OS、ブラウザーと支援技術のバージョン、ビルド、実施日、各手順の実際の結果を記録してください。テーマのトークン、背景、共通のコンポーネントのスタイルを変更した際は、再度確認します。
制限
このサンプルは、どのアプリケーションでも同じ結果になることを保証するものではありません。色の値とトークン名は例のため、実際の背景で実際の枠を測定してください。3:1に届いた枠でも、細ければ見つけにくいことがあります。達成基準2.4.13はさらに厳しい条件を求めており、フォーカス表示の見え方のガイドで扱います。枠を頼りにする人と一緒に、操作の流れ全体を確認してください。
よくある問題を再現した学習用のサンプルです。実在のクライアントの診断結果ではありません。コードは出発点となる実装例のため、実際の製品でも確認してください。ここでは支援技術でのテスト結果は報告していません。
EaseWebのサービス
修正した問題を、次のリリースで再発させない
このガイドのような修正方法を、コーディングエージェントが従うルールと、CIのチェックに組み込みます。あわせて定期的に、キーボードとスクリーンリーダーで手動の再テストを行います。