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