# マウスでしか拡大できない商品写真

Source: https://easeweb.dev/learn/hover-zoom
Topics: 複雑なウィジェット > 商品写真のギャラリーをキーボードで切り替え・拡大でき、表示中の写真が伝わる (WCAG 2.1.1, 4.1.2)
The fix: マウスの動きに合わせた拡大は近道として残し、Tabで届く入り口を加えます。スクロールできる枠の中で写真を大きくする「拡大」ボタン、大きな写真をHTML標準のダイアログで開くボタン、元サイズの写真へのリンクのいずれかです。
Test with: keyboard, speech input, forced colors
References: https://www.w3.org/WAI/WCAG22/Understanding/keyboard.html https://www.w3.org/WAI/WCAG22/Techniques/failures/F54 https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dialog https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/tabindex https://github.com/imgix/drift https://www.jacklmoore.com/zoom/

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

## 場面

あるショップがホーローマグを売っています。商品ページには大きな写真が1枚あり、その下に正面、側面、背面のサムネイル、横に「カートに入れる」ボタンが並びます。背面には「Dishwasher safe」「350 ml」という小さな印字があり、写真の大きさでは読めません。マウスなら簡単です。写真の上でポインターを動かすと、その周りが3倍に拡大され、印字が読めるようになります。

サムネイルは名前の付いたボタンなので、キーボードでも背面のサムネイルへTabで移動してEnterキーを押せば、背面の写真に変わります。拡大する方法を探してもう一度Tabキーを押すと、フォーカスはサムネイルから「カートに入れる」へ移ります。写真にはフォーカスを受けるものがなく、どのキーを押しても大きくならないので、印字はぼやけた灰色のままです。

よく使われる拡大用ライブラリーは、初期設定のままではこう動きます。Driftは「zoom on hover」をうたうライブラリーで、jQuery Zoomも設定を変えなければ `mouseover` で拡大が始まります。Driftの使用例は何も押すものがない画像にそのまま設定する形で、そのとおりに作ったページには、写真を大きく見るほかの手段がありません。

## 確認できる問題

達成基準2.1.1（キーボード）は、マウスでできることはすべてキーボードでもできるよう求めています。この例では、マウスなら写真を拡大し、写真の中を見て回れます。ところが拡大は `mousemove` にしか反応せず、このイベントはどのキーを押しても発生しません。同じことができるボタンもリンクもなく、Tabで止まる場所もありません。W3Cの失敗例F54が挙げているのがまさにこの場合で、ポインティングデバイス専用のイベントハンドラーでしか機能を実行できない状態を指します。ここでの機能は、写真の細部を見ることです。

フォーカスで拡大が始まるようにしても足りません。Tabで写真に届いて大きくなったとしても、拡大はポインターの位置に合わせて動くため、ポインターがなければ、読みたい部分へ表示を動かす手段がありません。

## 利用者への影響

容量、食洗機に対応しているか、布の織り目、ラベルに印刷されたサイズ表など、細部には買う人が知りたい情報がよく写っています。マウスを使えない人は、写真をすべて切り替えられても、そこに書かれた内容を読めません。

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

この診断では、キーを押して写真が大きくなるかを確かめることはできません。分かるのは、拡大用ライブラリーが残す目印です。Drift、elevateZoom、jQuery Zoom、Magentoの拡大鏡、拡大の設定を「クリックしてカーソルを合わせる」にしたShopifyのDawnテーマは、それぞれ決まった属性や要素をページに加えます。目印のある写真がリンクの中になく、近くでTabが届くコントロールにも拡大や写真を開くと分かる言葉がなければ、人が確認する手がかりとして `ew:hover-zoom-manual-check` を報告します。この例のように自前で書いた拡大には目印がなく、どのチェックでも見つかりません。

手がかりは問題の確定ではありません。ラベルだけを撮った写真を別に載せるなど、診断が知らない方法で同じ細部を見せているページもあります。逆に、手がかりが出ないからといって問題がないとも限りません。近くのボタンに「拡大」と書かれていれば、それが別のものを開くボタンでも、手がかりは出ません。axeが調べる対象もありません。写真はaltのある画像で、それだけなら問題になりません。

## 修正前：マウスの動きに合わせた拡大

```html
<div class="gallery">
  <div class="photo-frame">
    <img class="photo" src="mug-front.jpg" alt="マグの正面">
  </div>
  <div class="thumbs">…</div>
</div>
```

```css
.photo-frame { aspect-ratio: 1; overflow: hidden; }
.photo { display: block; width: 100%; }
```

```js
const frame = document.querySelector('.photo-frame');
const photo = frame.querySelector('.photo');
// 拡大はマウスの動きに合わせて行う。
frame.addEventListener('mousemove', (event) => {
  const box = frame.getBoundingClientRect();
  const x = ((event.clientX - box.left) / box.width) * 100;
  const y = ((event.clientY - box.top) / box.height) * 100;
  photo.style.transformOrigin = `${x}% ${y}%`;
  photo.style.transform = 'scale(3)';
});
frame.addEventListener('mouseleave', () => { photo.style.transform = ''; });
```

- 拡大は `mousemove` でしか始まらず、`mouseleave` で終わります。どちらもキーでは発生しません。
- ギャラリーには拡大のためにフォーカスを受けるものがありません。ボタンもリンクもなく、枠もTabの移動先になりません。
- そのため、キーボードでは写真を切り替えられても、細部は見られません。

## 修正後：拡大ボタンとスクロールできる枠

```html
<div class="gallery">
  <button type="button" class="zoom">拡大</button>
  <div class="photo-frame" role="region" aria-label="拡大した写真">
    <img class="photo" src="mug-front.jpg" alt="マグの正面">
  </div>
  <div class="thumbs">…</div>
</div>
```

```css
.photo-frame { aspect-ratio: 1; overflow: hidden; }
.photo { display: block; width: 100%; }
/* 拡大すると、写真はブラウザーがスクロールし、矢印キーでも動かせる。 */
.photo-frame.is-zoomed { overflow: auto; }
.photo-frame.is-zoomed .photo { width: 300%; max-width: none; }
```

```js
const frame = document.querySelector('.photo-frame');
const photo = frame.querySelector('.photo');
const zoom = document.querySelector('.zoom');
// マウスの動きに合わせた拡大は、近道として残す。ボタンで拡大している間は止める。
frame.addEventListener('mousemove', (event) => {
  if (frame.classList.contains('is-zoomed')) return;
  const box = frame.getBoundingClientRect();
  const x = ((event.clientX - box.left) / box.width) * 100;
  const y = ((event.clientY - box.top) / box.height) * 100;
  photo.style.transformOrigin = `${x}% ${y}%`;
  photo.style.transform = 'scale(3)';
});
frame.addEventListener('mouseleave', () => { photo.style.transform = ''; });
// ボタンで枠の中の写真を大きくし、写真の中央から見せる。
zoom.addEventListener('click', () => {
  const zoomed = frame.classList.toggle('is-zoomed');
  photo.style.transform = '';
  if (zoomed) frame.tabIndex = 0;
  else frame.removeAttribute('tabindex');
  zoom.textContent = zoomed ? '縮小' : '拡大';
  frame.scrollTo((frame.scrollWidth - frame.clientWidth) / 2, (frame.scrollHeight - frame.clientHeight) / 2);
});
```

1. 写真の上に「拡大」ボタンを置きます。Tabで先に届くよう、ページの中では写真より前に書きます。
2. 押したら、スクロールできる枠の中で写真の幅を3倍にし、写真の中央から見せます。
3. 拡大している間は枠をTabの移動先にし、役割と名前も付けます。Tabで届き、スクリーンリーダーには何の枠かが伝わり、矢印キーで写真の中を動けます。縮小したら、Tabの移動先から外します。
4. 拡大している間はボタンの文字を「縮小」にして、次に押すと何が起きるかが分かるようにします。
5. マウスの動きに合わせた拡大は近道として残し、ボタンで拡大している間は止めます。

これで修正前の問題が解消し、2.1.1を満たします。幅を3倍にしても細部が鮮明なように、十分に大きな画像ファイルを用意してください。

## 修正後：大きな写真をHTML標準のダイアログで見せる

```html
<div class="gallery">
  <button type="button" class="enlarge">写真を拡大</button>
  <div class="photo-frame">
    <img class="photo" src="mug-front.jpg" alt="マグの正面">
  </div>
  <div class="thumbs">…</div>
  <dialog class="large-view" aria-label="拡大した写真">
    <form method="dialog">
      <button>閉じる</button>
    </form>
    <div class="large-frame" tabindex="0" role="region" aria-label="大きな写真">
      <img src="" alt="">
    </div>
  </dialog>
</div>
```

```css
.photo-frame { aspect-ratio: 1; overflow: hidden; }
.photo { display: block; width: 100%; }
/* 枠より大きな写真はスクロールでき、矢印キーでも動かせる。 */
.large-frame { max-width: 80vw; max-height: 70vh; overflow: auto; }
.large-frame img { display: block; }
```

```js
const frame = document.querySelector('.photo-frame');
const photo = frame.querySelector('.photo');
const dialog = document.querySelector('.large-view');
const large = dialog.querySelector('img');
// マウスの動きに合わせた拡大は、近道として残す。
frame.addEventListener('mousemove', (event) => {
  const box = frame.getBoundingClientRect();
  const x = ((event.clientX - box.left) / box.width) * 100;
  const y = ((event.clientY - box.top) / box.height) * 100;
  photo.style.transformOrigin = `${x}% ${y}%`;
  photo.style.transform = 'scale(3)';
});
frame.addEventListener('mouseleave', () => { photo.style.transform = ''; });
// ボタンで写真を元のサイズで開く。フォーカスとEscapeキーはダイアログが処理する。
document.querySelector('.enlarge').addEventListener('click', () => {
  large.src = photo.currentSrc;
  large.alt = photo.alt;
  dialog.showModal();
});
```

1. 写真の上に「写真を拡大」ボタンを置き、ページの中では写真より前に書きます。
2. 押したら、表示中の写真をaltごと `dialog` に入れ、`showModal()` で開きます。フォーカスが中へ移り、背後のページは操作できなくなり、Escapeキーか「閉じる」ボタンで閉じ、閉じるとフォーカスはボタンへ戻ります。
3. 写真は元のサイズのまま枠に入れ、その枠をTabの移動先にして、役割と名前を付けます。矢印キーで写真の中を動けます。
4. マウスの動きに合わせた拡大は近道として残します。

これで修正前の問題が解消し、2.1.1を満たします。HTML標準の `dialog` では自前で作ることになる機能がほしいときは、代わりにライトボックスのライブラリーを使う手もあります。ただし、次のような機能を加えても、ダイアログはキーボードで使えるままにしてください。

- 写真のスワイプでの切り替え：前後の写真へのボタンを残し、スワイプだけにしない。
- ピンチでの拡大：拡大のボタンと、キーで写真の中を動く手段を残す。
- 開くときのアニメーション：フォーカスをダイアログへ移し、閉じたらボタンへ戻す動きを変えない。

HTML標準の `dialog` もアニメーションでき、中には上のボタンを含めて自由にマークアップを入れられます。

## 修正後：元サイズの写真へのリンク

```html
<div class="gallery">
  <div class="photo-frame">
    <img class="photo" src="mug-front.jpg" alt="マグの正面">
  </div>
  <div class="thumbs">…</div>
  <a class="full-size" href="mug-front.jpg">元サイズの写真を開く</a>
</div>
```

```css
.photo-frame { aspect-ratio: 1; overflow: hidden; }
.photo { display: block; width: 100%; }
```

```js
const frame = document.querySelector('.photo-frame');
const photo = frame.querySelector('.photo');
const link = document.querySelector('.full-size');
// マウスの動きに合わせた拡大は、近道として残す。
frame.addEventListener('mousemove', (event) => {
  const box = frame.getBoundingClientRect();
  const x = ((event.clientX - box.left) / box.width) * 100;
  const y = ((event.clientY - box.top) / box.height) * 100;
  photo.style.transformOrigin = `${x}% ${y}%`;
  photo.style.transform = 'scale(3)';
});
frame.addEventListener('mouseleave', () => { photo.style.transform = ''; });
// 写真が変わるたびに、リンク先も合わせる。
photo.addEventListener('load', () => { link.href = photo.currentSrc; });
```

1. ギャラリーの下に、写真のファイルへのリンクを置きます。Tabで届き、Enterキーでブラウザーがファイルを開き、「戻る」でページに戻れます。
2. 写真が変わるたびにリンク先を新しいファイルに合わせ、いつでも表示中の写真が開くようにします。
3. マウスの動きに合わせた拡大は近道として残します。

ブラウザーは大きな画像ファイルを、まずウィンドウに収めて表示します。Firefoxでは拡大表示のキーで大きくでき、ウィンドウより大きくなれば、矢印キーで写真の中を動けます。ほかのブラウザーでは、キーボードだけでどこまで大きくできるかを試してください。これで修正前の問題は解消しますが、2.1.1を満たすのは、ブラウザーがキーボードでのファイルの拡大を許し、ファイルが細部を見られるだけの大きさである間だけです。ここで挙げた中で最も小さな変更で、スクリプトの読み込み前でもリンクは動きます。

## どの方法を選ぶか

どの方法でも、マウスを使う人のための拡大は残せます。拡大ボタンとダイアログはどのブラウザーでも基準を満たしますが、リンクが満たすのは、開いたファイルをブラウザーがキーボードで拡大させる場合だけです。違うのは、もっと見たいと思ったときに何が表示されるかです。拡大ボタンはその場で写真を大きくするもので、デザインで占める場所が最も少なくて済みますが、見える範囲は写真の枠の大きさのままで、スマートフォンでは狭くなります。ダイアログは写真に画面の大部分を使え、商品ページでよく見る形です。WooCommerceは、テーマがギャラリーの拡大とライトボックスを両方有効にしていれば、マウスでの拡大を残したまま、写真を開くコントロールを足します。ShopifyのDawnテーマも、初期設定ではボタンから写真を開きます。ダイアログはマークアップが少し増え、閉じるまでページのほかの部分は操作できません。リンクは数行で済み、壊れる心配もほとんどありませんが、ページから離れることになり、拡大はブラウザー任せになります。WooCommerceのギャラリーでも、マウスでの拡大の下で、各写真が元サイズのファイルへのリンクに入っています。手間をかけられないときに選ぶほか、スクリプトが動かなくても大きな写真に届くよう、ダイアログの土台にもしてください。

## 実装の判断

拡大の枠がTabの移動先になる必要があるのは、スクロールできる間だけです。そのため1つ目の修正では、拡大したときに `tabindex` を付け、戻したら外します。何もしないのに止まる場所があると、キーボード利用者が通り過ぎる手間が増えます。

`srcset` で小さな画面に小さなファイルを配信しているページでは、`currentSrc` も小さなファイルになります。ダイアログとリンクには最も大きなファイルを指定してください。Driftの `data-zoom` のように、最も大きなファイルはデータ属性に入れておき、`src` を変えるときに一緒に変えます。

画像そのものをクリックすると大きく開くメインの写真も、マウスでの拡大と同じ理由で2.1.1を満たしません。ダイアログの修正のように横にボタンを置くか、写真を大きなファイルへのリンクで囲みます。リンクで囲むのはPhotoSwipeがマークアップとして求める形で、Fancyboxの例も同じ形です。スクリプトが読み込まれていればライトボックスが開き、読み込まれていなければファイルが開きます。写真の上に描くレンズはフォーカスを必要としないので、残してかまいません。

タッチスクリーンにはホバーがありません。Driftは初期設定でタッチでも拡大を始め、WooCommerceはタッチスクリーンではjQuery Zoomをタップで始まるように切り替えるので、そこでは拡大が使えることも多いでしょう。修正で加えたコントロールはタッチスクリーンでも使え、ライブラリーの設定には左右されません。

写真に `tabindex="0"` を付けてフォーカスで拡大を始めても、写真の決まった一部分が見えるだけで、ほかの部分へ移る手段がありません。

## 修正の確認

1. マウスを使わずに、Tabでギャラリーを移動する。写真を拡大する、大きくする、または開くコントロールがTabの移動先になり、フォーカスの枠が見え、Enterキーで押せる。
2. 最も細かい部分がある写真を表示して、そのコントロールを使う。矢印キーだけで大きくした写真の中を動き、細部が読める。
3. 「縮小」、Escapeキー、「戻る」のいずれかでページに戻り、元の位置からTabで先へ進める。
4. 音声操作で「クリック」とコントロールの見える文字を言う。そのコントロールが押される。
5. 強制配色（Windowsのコントラスト テーマ）をオンにする。コントロールと、大きくした写真のフォーカスの枠が見える。

OS、ブラウザーと支援技術のバージョン、ビルド、実施日、各手順の実際の結果を記録してください。ギャラリー、ライブラリー、テーマを変更した際は、再度確認します。

## 制限

このサンプルは、どのアプリケーションでも同じ結果になることを保証するものではありません。扱うのは、マウスでの拡大で見える細部へキーボードで届くかです。写真を切り替えるサムネイルは、[マウスでしか選べず、何の写真かも伝わらない商品写真のサムネイル](/ja/learn/image-galleries)で扱います。ライトボックスのフォーカスと閉じ方については、[背後にフォーカスが残るモーダル](/ja/learn/modal-focus-management)を参照してください。ドラッグ、ピンチ、傾きで回したり拡大したりする写真の表示は、[代わりのボタンがないピンチ・ドラッグ・傾きのジェスチャー](/ja/learn/gestures)で扱います。ブラウザーの拡大表示や画面拡大ソフトでも写真は大きくなりますが、それは利用者側の道具です。このガイドが扱うのは、ページが用意する拡大です。

---

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