---
title: アクセシビリティパネル
sidebar:
  order: 4
---

アクセシビリティのボタンを押すと、プレビューの中で [axe-core](https://github.com/dequelabs/axe-core) を動かし、見つかった問題を一覧にします。一覧には深刻度、説明、詳しい説明へのリンク、該当する要素が並びます。

<img
  className="shot-light"
  src="/svelte-zukan/screenshots/a11y-light.webp"
  alt="プレビューの下のアクセシビリティパネル。カードは D 型色覚での見え方で表示されている"
  width="1280"
  height="860"
/>
<img
  className="shot-dark"
  src="/svelte-zukan/screenshots/a11y-dark.webp"
  alt="プレビューの下のアクセシビリティパネル。カードは D 型色覚での見え方で表示されている"
  width="1280"
  height="860"
/>

- 問題のある要素はプレビューの中で深刻度の色の枠で囲まれます。一覧の要素にカーソルを当てるかフォーカスすると枠が太くなり、クリックすると太いまま残って、その位置までスクロールします。Shadow DOM の中の要素は、ホスト要素のセレクター、`>>>`、Shadow DOM の中でのセレクターの順に並べて表示します
- 画像やグラデーションの上にある文字のコントラストのように、axe-core だけでは判定できない項目は「手動での確認が必要」として別に並び、プレビューでは破線の枠で囲まれます。ルールごとの説明（「詳しく」）を読み、自分で確かめてください。コントラストのように目で見て確かめるものも、ARIA 属性のようにそうでないものもあります。ほかに問題がないときも、「問題は見つかりませんでした」ではなくこちらを表示します
- パネルを開いている間は、編集のたびに検査し直します。プレビューが再読み込みされずにその場で書き換わったときも、テーマや幅を切り替えたときも同じです
- 「見え方」ではぼやけた視界や色覚特性（P 型、D 型、T 型、1 色覚）での見え方を再現します。各チップにはその見え方での色の見本があります
- 「確かめる」には、axe-core では分からないことを確かめる 2 つのスイッチがあります
  - 「文字 200%」は、ブラウザーの既定の文字サイズを上げたときと同じように、プレビューの基準の文字サイズを 2 倍にします。はみ出したり重なったりする文字が分かります。`px` で大きさを固定した文字は大きくならず、これも直したほうがよい点です（[WCAG 1.4.4](https://www.w3.org/WAI/WCAG22/Understanding/resize-text.html)）
  - 「Tab の順番」は、Tab キーでフォーカスが移る要素に、移る順の番号を付けます。プレビューが変わると付け直します。Shadow DOM や iframe の中の要素は対象外です
- 見え方と 2 つのスイッチは、パネルを閉じたりプレビューが再読み込みされたりすると元に戻ります
- `locale: 'ja'` のときは、axe-core の指摘も日本語になります
- 読み込めなかったセクションや、描画中にコンポーネントがエラーを投げたセクションは、検査せずにそのエラーを表示します

axe-core は検査を実行したときにだけ、カタログのスクリプトファイル（dev サーバーでは `/__zukan/axe.js`、[静的書き出し](/svelte-zukan/ja/static-export)では `_zukan/` の下のファイル）として読み込みます。そのため Content-Security-Policy が `script-src 'self'` でも動きます。ページのすべての内容をランドマークで囲むよう求めるルールは、単体のコンポーネントには当てはまらないので外しています。
