クラフトに伴うアクセシビリティ
アクセシビリティは最後に付け加えるコンプライアンスのチェックボックスではありません。それはインターフェースクラフトの基盤です。プラットフォームを活用すれば、そのほとんどは無料で手に入ります。ネイティブ要素にはキーボードサポートが組み込まれ、適切なラベルは自動的に読み上げられ、可視のフォーカスリングは1つのCSSルールで実現できます。UIコードを構築・レビューする際にこれらの原則を適用し、修正を適用する際はプロジェクトの既存のスタイリングシステム(Tailwind、プレーンCSS、CSS-in-JS)に合わせてください。
レビュー時は、まずキーボードのみでユーザーとしてインターフェースを操作します(すべてのフローがマウスなしで完了できる必要があります)。次にスクリーンリーダーユーザーとして、各コントロールが名前、役割、状態を正しく読み上げるかを確認します。不明な場合は、カスタムで再構築するよりもプラットフォームのデフォルトを優先し、ARIAを追加するのではなく削除してください。
レンダリングペアのコントラスト測定と色の修正は better-colors スキル、視覚的なテキストサイズとiOSの入力ズームは better-typography、空間的なRTLレイアウトは better-layout がカバーします。
クイックリファレンス
| カテゴリ | 使用するタイミング |
|---|---|
| フォーカスとキーボード | フォーカスリング、スキップリンク、tabindex、フォーカストラップ、APGキーボードパターン |
| セマンティクスとARIA | ネイティブ要素を優先、button vs link、ランドマーク、アクセシブル名、無効状態 |
| フォーム | ラベル、オートコンプリート、エラーメッセージ、input type |
| スクリーンリーダー | 視覚的に隠されたコンテンツ、ライブリージョン、トースト、altテキスト、SVG |
| ヒットエリア | ターゲットサイズ、ヒットエリアの拡張、衝突ルール |
| モーションとズーム | prefers-reduced-motion、自動再生と時間指定UI、200%ズーム、リフロー、rem vs px |
コア原則
1. ネイティブ要素を優先
ARIAの第一のルール:ネイティブ要素が存在する場合はARIAを使用しないこと。アクションには <button>、ナビゲーションには <a href>(Cmd/Ctrl/ミドルクリックをサポートする必要があります)、<div onClick> は絶対に使用しないでください。ARIAがないことは、悪いARIAよりも優れています。
2. 可視のフォーカスリング
:focus ではなく :focus-visible をスタイル設定します。これにより、キーボードユーザーにはフォーカスリングが表示され、マウスユーザーには通常表示されません。ブラウザの未変更のフォーカスインジケーターを優先します。デザインでカスタムリングが必要な場合は、プロジェクトのフォーカストークンまたは別の明示的な色を使用し、インジケーター全体が交差するすべての隣接色に対して検証します。currentColor は、同じチェックを行った後でのみ許容されます。少なくとも 2px の実線の周囲、または同等の可視領域を使用してください。検証済みの代替なしに outline: none を使用したり、forced-colorsモードでシステムカラーを保持したりしないでください。
3. 完全なキーボードサポート
すべてのポインター操作には、ARIA APGパターンに従ったキーボードパスが必要です。Escapeでオーバーレイを閉じ、矢印キーで複合ウィジェット(タブ、メニュー、リストボックス)内を移動し、Tabでウィジェット間を移動し、EnterとSpaceでアクティブ化します。tabindex="0"(自然なタブ順序に参加)と tabindex="-1"(プログラムによるフォーカス)のみを使用し、自然な順序を壊す正の値は使用しないでください。複合ウィジェットはロービングtabindexを使用します。アクティブなアイテムは 0、それ以外はすべて -1 です。
4. フォーカスのトラップと復元
モーダルは背景コンテンツに inert を設定し、開くときに内部にフォーカスを移動し、閉じるときにトリガーにフォーカスを戻します。背景コンテンツがスクロールしないように overscroll-behavior: contain を追加します。
5. 最小ヒットエリア
WCAG 2.5.8のレベルAA基準は、24×24 CSSピクセルのターゲット、または定義された間隔、同等のコントロール、インライン、ユーザーエージェント、または必須の例外のいずれかです。より簡単なアクティブ化のために、タッチコンテキストでは44×44px、密度が許せばデスクトップインターフェースでは40×40pxを目指します。可視要素を小さく保つ必要がある場合は、疑似要素で拡張してください。拡張されたヒットエリアが重ならないように注意してください。
6. すべてのコントロールにラベルとタイプを設定
すべての入力には <label for> またはラッピング <label> を付けます。プレースホルダーはラベルではありません。ラベルとコントロールは1つのヒットターゲットを共有します。チェックボックスとそのテキストの間にデッドゾーンを作らないでください。意味のある name で autocomplete を追加し、キーボードに適した正しい type と inputmode を設定します。ペーストをブロックしないでください。ユーザーはパスワードとワンタイムコードをペーストします。
7. エラーを通知する
リクエストが開始されるまで送信を有効にしておき、その後スピナーで無効にしても元のラベルは保持します。送信時に検証します。失敗したフィールドに aria-invalid="true" を設定し、aria-describedby でインラインエラーテキストを指し、最初の無効なフィールドにフォーカスします。ネイティブコントロールが本当に使用できない場合にのみ、ネイティブの disabled を使用します。フォーカス可能性や発見可能性を意図的に保持する場合にのみ aria-disabled="true" を使用し、その場合はコードでポインター、キーボード、フォームの動作をブロックし、状態を明示的にスタイル設定します。
8. どこでもアクセシブルな名前
アイコンのみのボタンには、説明的な aria-label が必要です。可視のラベルテキストはアクセシブルな名前に含まれている必要があります。装飾的な要素には aria-hidden="true" を設定しますが、フォーカス可能な要素には決して設定しないでください。
9. 色だけに頼らない
ステータスには、色と一緒にアイコン、テキスト、または下線などの冗長な手がかりが必要です。コンテンツと状態に基づいて適用されるWCAGコントラスト要件を判断し、better-colors を使用してレンダリングされた前景/背景ペアを測定します。コントラストが失敗した場合は、ペアとそれが満たしていない要件を報告します。プロジェクトの色を尋ねられずに変更しないでください。
10. prefers-reduced-motionを尊重
モーションは @media (prefers-reduced-motion: no-preference) でラップし、オプトインにします。動きの抑制が設定されている場合、スライドやスケールを不透明度のクロスフェードに置き換え、パララックスや自動再生を完全に停止します。設定に関係なく、自動再生メディアには可視の一時停止コントロールが必要であり、アクションやエラーを含むトーストはユーザーが閉じるまで表示されたままにします。
11. 動的コンテンツを通知する
フィールド固有の検証には aria-describedby を使用し、コントロールに関連しない緊急でない更新(トーストや結果件数など)にはpoliteライブリージョン(role="status")を使用し、コントロールに関連しない緊急エラーには role="alert" のみを使用します。信頼性の高い繰り返しのpolite通知には、テキストを更新する前に安定した空のリージョンをレンダリングします。動的に挿入されるアラートはサポート状況が異なるため、ターゲットのスクリーンリーダーでテストする必要があります。
12. 目的に応じたaltテキスト
装飾的な画像には alt=""、情報を伝える画像は意味を説明し、機能的な画像はアクションを説明します。検索アイコンボタンは alt="Search" であり、alt="magnifying glass" ではありません。
13. 構造はナビゲーション
セクションを説明し、一貫したアウトラインを形成する見出しを使用します。1つのページレベルの <h1> と適切にネストされたレベルが推奨されるデフォルトであり、スタンドアロンのWCAG合否ルールではありません。1つの可視のプライマリ <main> ランドマークを公開します。繰り返しのナビゲーションやクロームがその前に配置されている場合は、「スキップしてコンテンツへ」リンクを最初のフォーカス可能な要素にします。アンカー付きの見出しには scroll-margin-top を設定します。
14. ズームとテキストサイズ変更に耐える
ページは200%ズームと320px幅でのリフローで水平スクロールなしで動作する必要があります。テキストコンテナには固定の height ではなく min-height を使用し、コードベースの慣習に合う場合は rem ブレークポイントを優先し、ビューポートのメタタグでユーザーのズーム範囲を制限しないでください。
よくある間違い
| 間違い | 修正 |
|---|---|
フォーカスリングを削除するために outline: none | 代わりに :focus-visible をスタイル設定。マウスクリックでは表示されません |
| カスタムフォーカス色がどこでも機能すると仮定 | すべての隣接色とforced-colorsモードでインジケーター全体を検証 |
ボタンまたはリンクに <div onClick> | アクションには <button>、ナビゲーションには <a href> |
| プレースホルダーを唯一のラベルとして使用 | 可視の <label for> を追加。プレースホルダーは入力時に消えます |
フォーカス順序を修正するための正の tabindex | DOMの順序を修正。0 と -1 のみを使用 |
| 繰り返されるpolite更新の通知が一貫しない | 安定した空のステータスリージョンを維持し、そのテキストを更新。ターゲットのスクリーンリーダーをテスト |
ルーチンのトーストに対する assertive ライブリージョン | polite を使用。assertive はエラーのために予約 |
フォーカス可能な要素への aria-hidden="true" | 削除するか、要素をフォーカス不可にする |
| 機能的なアイコンのaltが画像を説明 | アクションを説明:alt="Search"、alt="magnifying glass" ではない |
| フォームが有効になるまで送信を無効 | 有効にしておき、送信時に検証して最初のエラーにフォーカス |
レビュー出力形式
この形式は、ユーザーがスタンドアロンのアクセシビリティレビューを明示的に要求した場合にのみ使用します。better-interface がレビューを調整する場合は、ドメインのエビデンスと発見事項をそのスキルに提供し、そのスキルの出力形式、重大度スケール、統合ルール、上限、判定を優先させます。
スタンドアロンレビューは2つのパートで提示します。
発見事項
確認されたすべての発見事項を原則ごとにグループ化します。重大度、場所、修正前、修正後、理由 の列を持つマークダウンテーブルを使用します。「修正前:」/「修正後:」の別々の行は絶対に使用しないでください。
- 重大度:
HIGHはタスクを妨げる、支援技術からコンテンツを隠す、または体系的なアクセシビリティ障害を作り出す。MEDIUMは操作を著しく困難にする。LOWは孤立した洗練の問題。 - 場所:
path/to/file:lineを引用。成果物にソースファイルがない場合は、代わりに正確な画面とコンポーネントを引用。 - 修正前 / 修正後: 現在の実装と実行可能な代替案を示す。
- 理由: 違反した原則とそのユーザーへの影響を挙げる。
繰り返される体系的な問題は1行に統合し、影響を受けるすべての場所をリストします。発見事項のない原則は省略します。
例
どこでもアクセシブルな名前
| 重大度 | 場所 | 修正前 | 修正後 | 理由 |
|---|---|---|---|---|
| HIGH | src/Dialog.tsx:42 | <button><XIcon /></button> | aria-label="Close" を追加。アイコンを aria-hidden="true" に設定 | アイコンのみのコントロールにアクセシブルな名前がない |
| HIGH | src/Nav.tsx:18 | <a href="/settings"><GearIcon /></a> | aria-label="Settings" を追加 | リンク先がスクリーンリーダーで利用できない |
可視のフォーカスリング
| 重大度 | 場所 | 修正前 | 修正後 | 理由 |
|---|---|---|---|---|
| HIGH | src/button.css:12 | button:focus { outline: none; } | button:focus-visible { outline: 2px solid; outline-offset: 2px; } | キーボードユーザーがフォーカスを見られない |
| HIGH | src/Menu.tsx:31 | focus:outline-none | focus-visible:outline-2 focus-visible:outline-offset-2 | メニューナビゲーションに可視のフォーカスインジケーターがない |
エラーを通知する
| 重大度 | 場所 | 修正前 | 修正後 | 理由 |
|---|---|---|---|---|
| HIGH | src/EmailField.tsx:27 | エラーが border-red-500 だけで表示される | aria-invalid="true" + インラインエラーテキストを示す aria-describedby="email-error" を追加 | 色だけではエラーを説明も通知もしない |
| MEDIUM | src/SignupForm.tsx:64 | フォームが有効になるまで送信が無効 | 送信を有効に保ち、失敗時に最初の無効なフィールドにフォーカス | 無効なアクションは何を修正すべきかを隠す |
最小ヒットエリア
| 重大度 | 場所 | 修正前 | 修正後 | 理由 |
|---|---|---|---|---|
| MEDIUM | src/Toolbar.tsx:22 | size-4 アイコンのみのボタン | after:absolute after:size-11 でヒットエリアを44×44pxに拡張 | ターゲットが小さすぎてタッチ入力が信頼できない |
検証と判定
発見事項の後:
- 検証: 実行した正確なチェックとその観察結果をリストします。キーボードトラバーサル、アクセシブル名の検査、適用可能な場合はスクリーンリーダーまたは自動チェックを含めます。チェックが実行されなかった場合は、まだ検証が必要なものを記載します。
- 判定:
HIGHの発見事項が残っている場合はBlock、MEDIUMまたはLOWの発見事項のみが残っている場合はNeeds changes、実行可能な発見事項がまったく残っていない場合のみApprove。
発見事項がない場合は、テーブルを省略し、「実行可能なアクセシビリティ発見事項はありません」と記載し、検証を報告し、Approve で終了します。