アクセシビリティとWCAG
セマンティックHTML
<!-- 汎用のdivではなく、セマンティック要素を使用 -->
<header>
<nav aria-label="メインナビゲーション">
<ul>
<li><a href="/" aria-current="page">ホーム</a></li>
<li><a href="/products">製品</a></li>
<li><a href="/about">会社概要</a></li>
</ul>
</nav>
</header>
<main>
<article>
<h1>製品詳細</h1>
<section aria-labelledby="specs-heading">
<h2 id="specs-heading">仕様</h2>
<dl>
<dt>重量</dt>
<dd>1.2 kg</dd>
<dt>寸法</dt>
<dd>30 x 20 x 10 cm</dd>
</dl>
</section>
</article>
</main>
<footer>
<p>© 2024 会社名</p>
</footer>
ランドマークとして<div>の代わりに<nav>、<main>、<article>、<section>、<aside>を使用します。スクリーンリーダーはこれらを使ってページ内を移動します。
ARIAパターン
function Modal({ isOpen, onClose, title, children }) {
if (!isOpen) return null;
return (
<div
role="dialog"
aria-modal="true"
aria-labelledby="modal-title"
onKeyDown={(e) => e.key === "Escape" && onClose()}
>
<h2 id="modal-title">{title}</h2>
<div>{children}</div>
<button onClick={onClose} aria-label="ダイアログを閉じる">
<XIcon aria-hidden="true" />
</button>
</div>
);
}
function Tabs({ tabs, activeIndex, onChange }) {
return (
<div>
<div role="tablist" aria-label="設定セクション">
{tabs.map((tab, i) => (
<button
key={tab.id}
role="tab"
id={`tab-${tab.id}`}
aria-selected={i === activeIndex}
aria-controls={`panel-${tab.id}`}
tabIndex={i === activeIndex ? 0 : -1}
onClick={() => onChange(i)}
onKeyDown={(e) => handleArrowKeys(e, i, tabs.length, onChange)}
>
{tab.label}
</button>
))}
</div>
{tabs.map((tab, i) => (
<div
key={tab.id}
role="tabpanel"
id={`panel-${tab.id}`}
aria-labelledby={`tab-${tab.id}`}
hidden={i !== activeIndex}
tabIndex={0}
>
{tab.content}
</div>
))}
</div>
);
}
キーボードナビゲーション
function handleArrowKeys(
event: React.KeyboardEvent,
currentIndex: number,
totalItems: number,
onSelect: (index: number) => void
) {
let newIndex = currentIndex;
switch (event.key) {
case "ArrowRight":
case "ArrowDown":
newIndex = (currentIndex + 1) % totalItems;
break;
case "ArrowLeft":
case "ArrowUp":
newIndex = (currentIndex - 1 + totalItems) % totalItems;
break;
case "Home":
newIndex = 0;
break;
case "End":
newIndex = totalItems - 1;
break;
default:
return;
}
event.preventDefault();
onSelect(newIndex);
}
すべてのインタラクティブ要素はキーボードで到達可能である必要があります。Tabキーでフォーカス移動、Enter/Spaceキーでアクティブ化、矢印キーでコンポーネント内の移動を行います。
フォームのアクセシビリティ
function SignupForm() {
return (
<form aria-labelledby="form-title" noValidate>
<h2 id="form-title">アカウント作成</h2>
<div>
<label htmlFor="email">メールアドレス</label>
<input
id="email"
type="email"
required
aria-required="true"
aria-describedby="email-hint email-error"
aria-invalid={hasError ? "true" : undefined}
/>
<p id="email-hint">あなたのメールアドレスを共有することはありません。</p>
{hasError && (
<p id="email-error" role="alert">
有効なメールアドレスを入力してください。
</p>
)}
</div>
<button type="submit">アカウント作成</button>
</form>
);
}
色とコントラスト
:root {
--text-primary: #1a1a1a; /* 白地で15.3:1 */
--text-secondary: #595959; /* 白地で7.0:1 */
--text-on-primary: #ffffff; /* ブランドカラー上で4.5:1以上を確保 */
--border-focus: #0066cc; /* 可視フォーカスリング */
}
*:focus-visible {
outline: 3px solid var(--border-focus);
outline-offset: 2px;
}
.error-message {
color: #d32f2f;
/* 色だけに頼らない - アイコンやテキスト接頭辞を追加 */
}
.error-message::before {
content: "エラー: ";
font-weight: bold;
}
WCAG AAでは、通常テキストで4.5:1、大きいテキスト(18px太字または24px標準)で3:1のコントラスト比が必要です。
アンチパターン
- クリック可能な要素に
buttonやaの代わりにdivやspanを使用する - フォーカスアウトラインを削除し、代替指標を提供しない
- 情報を伝えるために色だけに頼る(赤=エラー、緑=成功)
- 要素をラベル付けする可視テキストが存在する場合に
aria-labelを使用する - 一時停止機能なしでメディアを自動再生する
- キーボードユーザー向けのスキップナビゲーションリンクがない
チェックリスト
- すべてのインタラクティブ要素がキーボードでアクセス可能(Tab、Enter、Escape、矢印キー)
- セマンティックHTMLランドマークを使用(
nav、main、article、section) - 画像に説明文の
altテキストがある(装飾画像はalt="") - 色のコントラストがWCAG AAを満たしている(通常テキスト4.5:1、大きいテキスト3:1)
- すべてのインタラクティブ要素にフォーカスインジケータが表示される
- フォーム入力に
<label>要素が関連付けられている - エラーメッセージが
role="alert"でスクリーンリーダーに通知される - スクリーンリーダー(VoiceOver、NVDA)とキーボードのみでページをテスト済み