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

Source: https://easeweb.dev/learn/focus-ring-contrast
Topics: 色とコントラスト > コントロールとアイコンに十分なコントラストがある (WCAG 1.4.11)
The fix: フォーカスの枠を、どの背景でも隣接する色に対して3:1以上にします。背景ごとに枠の色を決めるか、両側に白を伴う2色の枠にするか、色の付いた帯の上では明るいボタンの内側に、ボタン自身の塗りの上で枠を描きます。
Test with: contrast measurement, keyboard, zoom, forced colors
References: https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html https://www.w3.org/WAI/WCAG22/Techniques/css/C40 https://developer.mozilla.org/en-US/docs/Web/CSS/outline-offset

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

## 場面

オンラインストアの白いヘッダーにメニューのリンクが並び、その下に「今週は送料無料」と書かれた青い帯があって、白いボタンが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つ目はデザインしたときの白いページに対してしか確かめていません。

## 利用者への影響

日差しの下で光沢のあるスマートフォンの画面を見るときや、暗いノートパソコンの画面では、誰にでも同じことが起こります。コントラストの低い枠は、真っ先に見えなくなります。

## 自動チェックとAIの限界

axeのようにスタイルシートを読む自動チェックは、要素にフォーカスしないため、フォーカスの枠を見ることがありません。EaseWebの監査は、ページごとに最大25個のコントロールにフォーカスし、その前後の画像を比べて、最も強い変化を元の色に対して測ります。そのため、この例の白の上の薄いグレーの枠も、帯の上の青い枠も検出できます。メニュー、ダイアログ、次のスライドなど後から現れるコントロールには届かず、ホバーのときだけ描かれる枠も測りません。デザインツールで選んだ枠やAIが書いた枠は、モックアップのページの色に対してしか確かめていないことがあります。ブランドの枠が白の上では合格し、帯の上で不合格になるのはそのためです。

## 修正前：文字色を半分の濃さにした枠

```css
: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;
}
```

- 枠の色は文字色を半透明にしたものなので、コントラストは文字の濃さ次第です。
- 白いヘッダーでは `#a1a1a1` に合成され、周りの白に対して2.58:1です。
- 帯の上では `#899ac7` に合成されて3.92:1になるため、問題が出るのは白の上だけです。

## 修正前：白の上でだけ基準を満たすブランドの青の枠

```css
: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 #1a4fd0;
  outline-offset: 2px;
}
```

- 白いヘッダーの上では6.83:1あるため、そこで確認を終えています。
- 帯の白いボタンの周りでは、枠が `#12348f` の帯の上に乗り、1.61:1しかありません。

## 修正後：背景ごとの枠

```css
: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;
}
```

1. 半透明ではない `--focus-ring` トークンを用意し、ページではブランドの青にします。白に対して6.83:1です。
2. 帯の上ではトークンを白に設定し直します。`#12348f` に対して10.97:1です。
3. 枠をトークンで描き、それぞれの背景で確かめた色が使われるようにします。

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

## 修正後：2色の枠

```css
: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 #1a4fd0;
  outline-offset: 2px;
  /* 青の両側に白 */
  box-shadow: 0 0 0 6px #fff;
}
```

1. 枠はブランドの青のまま、半透明にせず、コントロールの2ピクセル外側に描きます。
2. 枠より外まで広がる白の `box-shadow` を加えます。白が枠の内側のすき間を埋め、枠の外側にも出るため、青の両側には必ず白があり、6.83:1が保たれます。
3. 帯の上では、白い縁取りが帯と接し、`#12348f` に対して10.97:1になります。白いヘッダーでは縁取りはページに溶け込み、白の上の青がそのまま見えます。

これで2つの修正前の例はどちらも直り、1つのルールで、青か白のどちらかと十分なコントラストがある背景なら、どこでも1.4.11を満たします。コントラスト テーマでは影が消えますが、outlineは残ります。

## 修正後：ボタンの内側、塗りの上に描く枠

```css
: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 #1a4fd0;
  outline-offset: 2px;
}
/* 帯の上では、白いボタンの内側に枠を描く */
.sale-band .button:focus-visible {
  outline-offset: -5px;
}
```

1. 枠はブランドの青のまま、半透明にせず、コントロールの2ピクセル外側に描きます。白いヘッダーに対して6.83:1です。
2. 帯の上では、負の値の `outline-offset` で枠をボタンの内側に移します。枠はボタンの白い塗りの上に乗って6.83:1になり、帯には触れません。

これで2つの修正前の例はどちらも直り、帯のボタンは1.4.11を満たします。ただし、帯の上のコントロールがどれも明るい塗りを持っている場合に限ります。帯の上のテキストリンクや、塗りのない線だけのボタンでは、枠がまた `#12348f` の上に乗り、1.61:1に戻ります。枠はボタンの縁から5ピクセル内側を使うため、ボタンの余白はそれより大きくしておきます。

## どの方法を選ぶか

このページでは、3つとも1.4.11を満たします。背景ごとの枠は、ブランドの色1色のすっきりした見た目を保てますが、コンポーネントを置く背景ごとにトークンの値と確認が必要です。2色の枠は、青か白のどちらかと十分なコントラストがある背景なら、どれにも1つのルールで対応できますが、見た目は重くなります。達成方法C40は同じ考え方をさらに進め、白とほぼ黒のように2色の差を9:1以上にして、どんな背景でもどちらかの色と十分なコントラストが取れるようにします。ボタンの内側の枠は、明るいボタンしか置かない帯に向いていて、帯用の色も要りませんが、対象はそのボタンだけです。帯の上のほかのものには、背景ごとの枠か2色の枠が必要です。コントロールを置く背景がいくつあるか、編集者が新しい背景を足せるかで選びます。

## 実装の判断

何に対して測るかは、枠がどこにあるかで決まります。`outline-offset` が正の値のoutlineは背景の上に乗るため、白いページに置いたブランド色のボタンには、ブランド色の枠を使えます。枠はボタンではなく、白に対して測られるからです。コントロールの縁をまたいで内側と外側の両方にかかる枠は、どちらか一方の部分で3:1あれば足ります。ヘッダーのリンクやお知らせバーの矢印のように、テーマがコントロールの内側に描く枠は、コントロールの塗りに対して測ります。

色を半分の濃さにした枠や、フレームワークがブランド色を不透明度25%で描く柔らかい光のような半透明の枠は、下の色と混ざるため、コントラストが一定しません。それぞれの背景の上で合成された後の色を測るか、枠を不透明な色にします。`box-shadow` だけで描いた枠も同じで、さらにコントラスト テーマで消えてしまいます。[ハイコントラストモードで消えるフォーカス・アイコン・選択状態](/ja/learn/forced-colors)のとおり、outlineを残します。

カルーセルのトラックや、横にスクロールするカードの列など、親要素の `overflow: hidden` で、白い縁取りや外側の枠が欠けることがあります。コントロールの周りに余白を取るか、そこでは内側の枠を使います。ダークテーマにも専用の枠の値が必要です。[ダークモードでコントラストが足りなくなる文字とアイコン](/ja/learn/dark-theme-contrast)で扱います。

このガイドで扱うのは、枠の色と隣接する色との関係です。枠がまったくない場合は[見えないフォーカス表示](/ja/learn/visible-focus)、枠が細すぎて見つけにくい場合や、フォーカス前の色に近すぎる場合は、より厳しいAAAの基準として[細く薄くて見つけにくいフォーカス表示](/ja/learn/focus-appearance)で扱います。入力欄の枠、チェックボックス、アイコンは[コントラストが足りない入力欄・チェックボックス・アイコン](/ja/learn/non-text-contrast)で扱います。

## 修正の確認

1. ヘッダー、色の付いた帯、カード、フッター、各スライドなど、コントロールが置かれるすべての背景で、両方向にTab移動する。
2. コントラストチェッカーで、描かれた枠と隣の色（外側の枠なら背景、内側の枠ならコントロールの塗り）を測り、どの背景でも3:1以上あるか確認する。
3. 200%に拡大し、枠や縁取りが親要素で欠けていないか確認する。
4. コントラスト テーマを有効にし、フォーカスしたコントロールが枠で囲まれているか確認する。

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

## 制限

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

---

このガイドをコーディングエージェントで使う: MCP https://easeweb.dev/mcp（設定は https://easeweb.dev/ja/services/developers）
