本文へ移動
easeweb
ご相談
トピックを検索

背景とのコントラストが足りないフォーカスの枠

フォーカスの枠が隣の色に近く、白い背景では半透明の文字色が薄いグレーになり、青い帯の上ではブランドの青が埋もれてしまう

WCAG 2.2
SC 1.4.11AA· 2.1 で追加
必須とする規格
JIS X 8341-3 では必須ではない
問題あり outline: 2px solid #1a4fd0
アクセシビリティの問題を示した図: 弱視:フォーカスはどのボタン?
01

問題

弱視の利用者には、キーボードフォーカスがどのリンクやボタンにあるのか見つけられない

02

試してみる

Tabキーで、ヘッダーのリンクと青い帯のボタンを順に移動してみましょう

  • 問題1: 枠は文字色を半分の濃さにしたものです。帯の上では見えますが、白いヘッダーのリンクの周りでは薄いグレーの線になります。

  • 問題2: 枠はブランドの青です。ヘッダーでははっきり見えますが、帯のボタンの周りでは帯の青の上に乗ります。

  • 修正を適用します。 もう一度両方の背景をTabキーで移動すると、どちらでも枠がはっきり見えます。

問題あり 修正できますか?

再現デモです。「問題あり」は意図的にアクセシブルでない状態にしています。

03

修正方法

フォーカスの枠を、置かれるどの背景に対しても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ステップ
  1. 半透明ではない --focus-ring トークンを用意し、ページではブランドの青にします。白に対して6.83:1です。
  2. 帯の上ではトークンを白に設定し直します。#12348f に対して10.97:1です。
  3. 枠をトークンで描き、それぞれの背景で確かめた色が使われるようにします。

これで2つの修正前の例はどちらも直り、ここで設定した2つの背景で1.4.11を満たします。暗いフッターや色の付いたカードなど、背景が増えるたびに、その背景用の値と確認が必要です。

04

修正の確認

4項目、マウス不要

確認方法: コントラストの測定、キーボード、拡大表示、強制配色

4件中0件を確認済み

OS、ブラウザーと支援技術のバージョン、ビルド、実施日、各手順の実際の結果を記録してください。テーマのトークン、背景、共通のコンポーネントのスタイルを変更した際は、再度確認します。

制限

このサンプルは、どのアプリケーションでも同じ結果になることを保証するものではありません。色の値とトークン名は例のため、実際の背景で実際の枠を測定してください。3:1に届いた枠でも、細ければ見つけにくいことがあります。達成基準2.4.13はさらに厳しい条件を求めており、フォーカス表示の見え方のガイドで扱います。枠を頼りにする人と一緒に、操作の流れ全体を確認してください。

よくある問題を再現した学習用のサンプルです。実在のクライアントの診断結果ではありません。コードは出発点となる実装例のため、実際の製品でも確認してください。ここでは支援技術でのテスト結果は報告していません。

EaseWebのサービス

修正した問題を、次のリリースで再発させない

このガイドのような修正方法を、コーディングエージェントが従うルールと、CIのチェックに組み込みます。あわせて定期的に、キーボードとスクリーンリーダーで手動の再テストを行います。

サービス内容を見る