アクセシビリティ・オーディター は何をしますか?
Webアプリケーションのアクセシビリティ準拠(WCAG 2.1 Level AA)を監査し、改善点を提案します。
使用すべきタイミング
- UIコンポーネントの構築またはレビュー時
- ユーザーからアクセシビリティ改善のリクエストがあった場合
- アクセシビリティ監査の準備中
- ユーザーが「アクセシビリティ」「a11y」「WCAG」「スクリーンリーダー」「キーボードナビゲーション」に言及した場合
指示
1. セマンティックHTMLの確認
適切なHTML要素を使用する:
<!-- 悪い例 -->
<div onclick="submit()">送信</div>
<!-- 良い例 -->
<button onclick="submit()">送信</button>
セマンティック構造:
<header>、<nav>、<main>、<footer><article>、<section>、<aside><h1>から<h6>を適切な階層で- アクションには
<button>、ナビゲーションには<a>
2. ARIA属性
ARIAを使用すべき場合:
- カスタムウィジェット(タブ、アコーディオン、モーダル)
- 動的コンテンツの更新
- 複雑なインタラクション
- セマンティックHTMLだけでは不十分な場合
一般的なARIA属性:
<!-- ランドマークロール -->
<nav role="navigation" aria-label="メイン">
<!-- ウィジェットロール -->
<div role="button" tabindex="0" aria-pressed="false">
<!-- ライブリージョン -->
<div role="alert" aria-live="assertive">エラーが発生しました</div>
<!-- ラベルと説明 -->
<button aria-label="ダイアログを閉じる">×</button>
<input aria-describedby="password-help" />
ARIAの第一ルール: セマンティックHTMLで機能するならARIAを使わない
3. キーボードナビゲーション
すべてのインタラクティブ要素はキーボードで操作可能でなければならない:
// カスタム要素にキーボードサポートを追加
<div
role="button"
tabindex="0"
onClick={handleClick}
onKeyDown={(e) => {
if (e.key === 'Enter' || e.key === ' ') {
handleClick();
}
}}
>
クリックしてください
</div>
タブオーダー:
- カスタムインタラクティブ要素には
tabindex="0"を使用 tabindex > 0は避ける(混乱を招くタブオーダー)- プログラムによるフォーカス専用に
tabindex="-1"を使用
フォーカス管理:
- 可視のフォーカスインジケーター
- モーダル内でフォーカスをトラップする
- ダイアログを閉じる時にフォーカスを戻す
- メインコンテンツへのスキップリンク
4. 代替テキストと画像
情報を伝える画像:
<img src="chart.png" alt="第3四半期の売上が25%増加" />
装飾的な画像:
<img src="decoration.png" alt="" />
<!-- または -->
<img src="decoration.png" role="presentation" />
複雑な画像:
<figure>
<img src="complex-chart.png" alt="四半期売上チャート" />
<figcaption>
チャートデータの詳細な説明…
</figcaption>
</figure>
5. 色とコントラスト
コントラスト比(WCAG AA):
- 通常テキスト:最低4.5:1
- 大きいテキスト(18pt以上):最低3:1
- UIコンポーネント:最低3:1
色だけに頼らない:
<!-- 悪い例:色のみ -->
<span style="color: red;">エラー</span>
<!-- 良い例:アイコン+色 -->
<span style="color: red;">
<svg aria-hidden="true"><!-- エラーアイコン --></svg>
<span class="sr-only">エラー:</span>
無効な入力です
</span>
6. フォームとラベル
すべての入力項目にはラベルが必要:
<!-- 明示的なラベル -->
<label for="email">メールアドレス</label>
<input id="email" type="email" />
<!-- 暗黙的なラベル -->
<label>
メールアドレス
<input type="email" />
</label>
<!-- アイコンボタン用のaria-label -->
<button aria-label="検索">
<svg><!-- 検索アイコン --></svg>
</button>
エラーメッセージ:
<input
id="password"
aria-invalid="true"
aria-describedby="password-error"
/>
<div id="password-error" role="alert">
パスワードは8文字以上である必要があります
</div>
7. 見出しと文書構造
適切な見出し階層:
<h1>ページタイトル</h1>
<h2>セクション1</h2>
<h3>サブセクション1.1</h3>
<h3>サブセクション1.2</h3>
<h2>セクション2</h2>
レベルをスキップしない: h1 → h2 → h3 (h1 → h3 は不可)
8. 動的コンテンツ
スクリーンリーダーに更新を通知する:
<!-- ポライト:ユーザーの一時停止を待つ -->
<div role="status" aria-live="polite">
新しいメッセージが5件あります
</div>
<!-- アサーティブ:すぐに割り込む -->
<div role="alert" aria-live="assertive">
セッションは1分後に期限切れになります
</div>
読み込み状態:
<button aria-busy="true" aria-label="読み込み中…">
<span aria-hidden="true">読み込み中</span>
</button>
9. スクリーンリーダーテスト
スクリーンリーダー専用テキスト:
.sr-only {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border-width: 0;
}
装飾要素を隠す:
<svg aria-hidden="true"><!-- アイコン --></svg>
10. チェックすべき一般的な問題
不足しているもの:
- 画像の代替テキスト
- フォーム入力のラベル
- 適切な見出し階層
- キーボードフォーカスインジケーター
- アイコンボタンのARIAラベル
不適切なもの:
- 低コントラストのテキスト
- 非セマンティックなマークアップ(divをボタンとして使用)
- モーダルでのフォーカス管理の欠如
- キーボードトラップ
- 自動再生メディア
テスト:
- キーボードのみでのナビゲーション
- スクリーンリーダー(NVDA、JAWS、VoiceOver)
- 色覚シミュレーション
- 200%へのズーム
- 自動ツール(axe、Lighthouse)
11. 自動テスト
ツール:
# Lighthouse
npx lighthouse https://example.com --only-categories=accessibility
# axe-core
npm install --save-dev @axe-core/cli
npx axe https://example.com
# pa11y
npm install --save-dev pa11y
npx pa11y https://example.com
テスト内で:
import { axe } from 'jest-axe';
test('アクセシビリティ違反がないこと', async () => {
const { container } = render(<MyComponent />);
const results = await axe(container);
expect(results).toHaveNoViolations();
});
12. WCAG 2.1 Level AA チェックリスト
知覚可能:
- 非テキストコンテンツのテキスト代替
- オーディオ/ビデオのキャプション
- 適応可能なコンテンツ(セマンティックマークアップ)
- 十分な色のコントラスト
操作可能:
- キーボードアクセス可能
- キーボードトラップがない
- 適切な時間制限(調整可能)
- 発作を誘発する点滅がない
- ナビゲーションスキップリンク
- 説明的なページタイトル
- フォーカス順序が理にかなっている
- リンクの目的が文脈から明らか
理解可能:
- ページの言語が指定されている(
<html lang="ja">) - 予測可能なナビゲーション
- 入力支援(ラベル、指示、エラーメッセージ)
堅牢:
- 有効なHTML
- カスタムウィジェットの名前、役割、値
- 支援技術との互換性
ベストプラクティス
- アクセシビリティを最初から組み込む
- 実際の支援技術でテストする
- まずセマンティックHTML、次にARIA
- 論理的な文書構造を維持する
- コンテンツへの複数のアクセス方法を提供する
- キーボードナビゲーションを徹底的にテストする
- ズームを無効にしない
- ランドマークと見出しを使用する
サポートファイル
reference/wcag-checklist.md: WCAG 2.1 AA 完全チェックリストreference/aria-patterns.md: 一般的なARIAウィジェットパターン


