この記事で学ぶこと
#24 までで、lint・型・テスト・CI という「コードが正しく動くこと」を守る体制ができました。今回は品質のもう1つの軸です。正しく動くその画面は、マウスが使えない人、画面を目で見られない人、強い日差しの下でスマホを見ている人にも使えるでしょうか。これがアクセシビリティ(accessibility。長いので a11y と略されます)です。#21 で「この話は #25 で本格的に扱います」と予告した、ロールの正体もここで明かします。
- アクセシビリティが一部の人への特別対応ではなく、品質そのものである理由を説明できる
- セマンティックな HTML が機械に何を伝えているかを、アクセシビリティツリーで説明できる
- 「キーボードで一周する」「コントラスト比を測る」という2つの点検を自分のアプリにかけられる
迷ったら🔴だけ確実に(🔴 覚える、🟡 理屈、⚪ 流す)。
この記事のコードと実行結果は、すべて Node.js 20 + Vue 3.5 + Testing Library(#21)+ Playwright 1.64(#23、Chromium)で実際に動かして確認したものです。コントラスト比の数値も Node.js で計算した実測値です。
🔴 アクセシビリティは駅のエレベーター
駅のエレベーターは、車椅子の人のために作られました。でも実際に乗っているのは誰でしょう。ベビーカーの親、大きなスーツケースの旅行者、足を骨折した人、疲れている人。特定の誰かのために作った設備は、ほとんどの場合、全員の役に立ちます。
Web のアクセシビリティも同じ構図です。スクリーンリーダー(画面を音声で読み上げる支援技術)を使う人のために HTML を正しく書くと、その恩恵は目の見える人にも波及します。マウスより速いからとキーボードだけで操作するパワーユーザー。腱鞘炎で一時的にマウスを使えない人。真夏の屋外で、反射だらけの画面から低コントラストの薄文字を読み取れない人。つまり「障害」は人だけに宿るのではなく、状況にも宿ります。誰もが1日のどこかで、何かにアクセスしにくい状況に置かれています。
そしてもう1人、意外な受益者がいます。#21 のテストコードです。getByRole で部品を探せる画面は、機械が意味を読み取れる画面です。アクセシビリティの良い画面はテストも書きやすく、検索エンジンにも内容が正しく伝わります。人への優しさと機械への読みやすさは、同じ1つの性質なのです。
🔴 ブラウザは「見た目」と「意味」の2つを作っている
#1 で、ブラウザは HTML から DOM という木を作り、それを描画すると学びました。実はあのとき、話を1本省略していました。ブラウザは DOM からもう1つ、アクセシビリティツリーという木も作っています。
アクセシビリティツリーには、見た目の情報は入っていません。入っているのは各要素の意味です。role(ボタンなのか、見出しなのか、入力欄なのか)、名前(「保存」「品名」)、状態(押せるのか、チェック済みか)。スクリーンリーダーはこの木を読み上げ、キーボードのフォーカス移動もこの木の情報に従います。
ここで #21 の伏線を回収します。Testing Library の getByRole("button", { name: "保存" }) は、このアクセシビリティツリーから要素を探していました。だから「getByRole で見つかる画面はスクリーンリーダーでも操作しやすい」のです。同じ木を見ているのだから当然でした。
そして図の下に書いた一文が、この記事でいちばん大事な事実です。CSS がどれだけ頑張っても、届くのは見た目の枝だけ。意味の枝は、HTML の要素選びでしか作れません。
🔴 セマンティクス。意味は HTML でしか伝わらない
本当にそうなのか、機械の目で確かめます。CSS で完璧にボタンの見た目を与えた <div> を用意しました。クリックも @click で動きます。目で見るかぎり、本物のボタンと区別がつきません。
<script setup lang="ts">
const emit = defineEmits<{ save: [] }>();
</script>
<template>
<div class="btn" @click="emit('save')">保存</div>
</template>
<style scoped>
.btn {
display: inline-block;
padding: 8px 16px;
background: #3a7d44;
color: white;
border-radius: 6px;
cursor: pointer;
}
</style>
これを #21 のやり方で、ユーザーの目線から探してみます。
render(SaveButton);
screen.getByRole("button", { name: "保存" });
TestingLibraryElementError: Unable to find an accessible element with the role "button" and name "保存"
There are no accessible roles. But there might be some inaccessible roles.
2行目をよく読んでください。「アクセシブルなロールが1つも無い」。この部品は、機械の目には何者でもないただの箱と文字として映っています。ボタンの見た目をした絵が貼ってあるだけで、「ここに押せるものがある」という情報がどこにもありません。スクリーンリーダーは「保存」とだけ読み上げ、聞いている人はそれが押せるものだと知る術がありません。
直し方は、タグを1つ変えるだけです。
- <div class="btn" @click="emit('save')">保存</div>
+ <button class="btn" @click="emit('save')">保存</button>
これで上のテストは通ります(実測。ボタン標準の枠線が邪魔なら CSS に border: none; を足すだけです)。<button> と書いた瞬間、role、名前、Tab キーでの到達、Enter / Space での実行、読み上げ時の「保存 ボタン」という案内、全部がブラウザから無料で付いてきます。div に1つずつ後付けすることも技術的には可能ですが、最初から全部入りの部品があるのに使わない理由がありません。
これが**セマンティクス(semantics。意味論)**です。HTML の要素は見た目ではなく意味で選びます。判断に迷いやすいところだけ挙げます。
| 迷う場面 | 選び方 |
|---|---|
| ボタンかリンクか | 別のページへ移動するなら <a>、その場で何かが起きるなら <button>
|
| 見出しの級 | 見た目の大きさではなく文書の階層で h1 → h2 → h3(級を飛ばさない) |
| 入力欄の説明 |
placeholder ではなく <label> を for と id で紐づける(#23 でやった形) |
| ただの入れ物 | 意味を持つ要素が無いときだけ <div> / <span>
|
リンクとボタンの使い分けは理由ごと覚えてください。スクリーンリーダーの利用者は「このページのリンク一覧」「ボタン一覧」という目次機能で画面を流し読みします。移動するはずのものがボタンだと、その目次から漏れます。
🔴 キーボードだけで一周する
2つ目の点検です。マウスを封印して、Tab(次へ)、Shift + Tab(前へ)、Enter / Space(実行)だけでアプリを一周できるか。スクリーンリーダー利用者も、運動障害でマウス操作が難しい人も、キーボード派のパワーユーザーも、全員この経路で操作します。
手で試してもいいのですが、せっかく #23 で Playwright を覚えたので、点検をテストコードにします。対象はおなじみの買い物リストです。
import { test, expect } from "@playwright/test";
test("マウスを使わず、キーボードだけで品物を追加できる", async ({ page }) => {
await page.goto("/");
await page.keyboard.press("Tab");
await expect(page.getByLabel("品名")).toBeFocused();
await page.keyboard.type("牛乳");
await page.keyboard.press("Tab");
await expect(page.getByRole("button", { name: "追加" })).toBeFocused();
await page.keyboard.press("Enter");
await expect(page.getByRole("listitem")).toHaveText("牛乳");
});
マウス操作(click や fill)を一切使っていない点が今までと違います。page.keyboard で物理キーボードを再現し、toBeFocused()(いまフォーカスが当たっているか)で現在地を確かめながら進みます。
✓ 1 e2e/keyboard.spec.ts:3:1 › マウスを使わず、キーボードだけで品物を追加できる (194ms)
1 passed (1.4s)
通りました。<label> と <input> と <button> で素直に作った画面は、何も足さなくてもキーボードで一周できます。
では、追加ボタンをさっきの <div class="btn"> に差し替えるとどうなるか。まずこのテスト自体が「追加というボタンが見つからない」で落ちます。ロールが消えたからです。ならばと、ロールに頼らずテキストで探して「Tab を2回押せばフォーカスが来るはず」を確かめると、こう落ちました。
Error: expect(locator).toBeFocused() failed
Locator: getByText('追加')
Expected: focused
Received: inactive
Call log:
- Expect "toBeFocused" getByText('追加') with timeout 5000ms
- waiting for getByText('追加')
14 × locator resolved to <div class="btn">追加</div>
- unexpected value "inactive"
Call log が状況を物語っています。要素そのものは見つかっている(locator resolved to <div class="btn">)のに、フォーカスは当たっていない(inactive)。**Tab キーは div を素通りします。**キーボードの人にとって、この「追加ボタン」は画面に存在しないのと同じです。マウスの人にはクリックで普通に動くので、この故障は開発中にまず気づかれません。だから意識して点検する価値があります。
もう1つ、キーボード操作の定番事故を挙げておきます。フォーカスが当たった要素を囲む枠線(フォーカスリング)を、「ダサいから」と CSS の outline: none で消してしまうことです。これはキーボードの人から現在地の表示を奪う行為です。見た目を変えたいならリングを消すのではなく、:focus-visible 擬似クラスで自分のデザインのリングに差し替えます。
🟡 コントラスト。おしゃれな薄グレーは読めない
3つ目の点検は色です。デザインを整えようとすると、文字色を薄いグレーにしたくなります。白地に薄グレー、たしかに上品に見えます。しかしそれは、良い照明の下で、良いディスプレイを、良い視力で見たときの話です。
文字の読みやすさはコントラスト比という数値で測れます。背景色と文字色の明るさの比で、完全な同色が 1:1、白地に黒が最大の 21:1。WCAG(Web Content Accessibility Guidelines)という国際的なガイドラインは、本文の文字に 4.5:1 以上を求めています(おおむね 24px 以上、太字なら約 18.7px 以上の大きな文字は 3:1 以上に緩和されます)。
計算式は決まっているので、Node.js で測定器を作って実測します。
// WCAGのコントラスト比を計算する
function luminance(hex) {
const [r, g, b] = [1, 3, 5].map((i) => {
const c = parseInt(hex.slice(i, i + 2), 16) / 255;
return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
});
return 0.2126 * r + 0.7152 * g + 0.0722 * b;
}
function contrast(fg, bg) {
const [l1, l2] = [luminance(fg), luminance(bg)].sort((a, b) => b - a);
return (l1 + 0.05) / (l2 + 0.05);
}
const pairs = [
["#aaaaaa", "#ffffff", "薄いグレーの注釈 on 白"],
["#777777", "#ffffff", "グレーの本文 on 白"],
["#767676", "#ffffff", "少し濃いグレー on 白"],
["#333333", "#ffffff", "濃いグレーの本文 on 白"],
["#ffffff", "#3a7d44", "白文字 on 緑のボタン"],
];
for (const [fg, bg, label] of pairs) {
const r = contrast(fg, bg);
console.log(`${fg} on ${bg} ${r.toFixed(2)}:1 ${r >= 4.5 ? "AA合格" : "不合格"} ${label}`);
}
#aaaaaa on #ffffff 2.32:1 不合格 薄いグレーの注釈 on 白
#777777 on #ffffff 4.48:1 不合格 グレーの本文 on 白
#767676 on #ffffff 4.54:1 AA合格 少し濃いグレー on 白
#333333 on #ffffff 12.63:1 AA合格 濃いグレーの本文 on 白
#ffffff on #3a7d44 5.00:1 AA合格 白文字 on 緑のボタン
注釈によく使われる #aaaaaa は 2.32:1 で、基準の半分です。面白いのは2行目と3行目で、#777777 は 4.48:1 でわずかに届かず、ほんの少し濃い #767676 が 4.54:1 で合格します。目で見分けるのはほぼ不可能な差です。つまりコントラストは目分量で判断できない、測るものだということです。
luminance の式の中身(12.92 や 2.4 という定数)は覚えなくてかまいません。人間の目の感度に合わせた補正です。覚えるのは「本文は 4.5:1」という基準と、測ればよいという態度だけ。普段の開発では自作スクリプトすら不要で、ブラウザの開発者ツールで文字を選択して色のスウォッチを開くと、コントラスト比と合否がその場に表示されます。
⚪ 道具に守らせる。そして ARIA の第一規則
#24 で「約束は機械に守らせる」と学びました。アクセシビリティも同じ流れに乗せられます。eslint-plugin-vuejs-accessibility を入れると、<img> の alt 忘れやラベルの無い入力欄を lint が指摘します。axe DevTools というブラウザ拡張や Lighthouse は、表示中のページのアクセシビリティ違反を自動検出します。自動検査で拾えるのは問題の一部と言われますが、ゼロ円で拾えるぶんは拾っておくに越したことはありません。
もう1つ、調べ物をすると必ず出会う WAI-ARIA に触れておきます。role="button" や aria-label のように、HTML に意味を後付けする属性群です。強力ですが、第一規則が「ネイティブの HTML 要素で表現できるなら ARIA を使うな」であることは知っておいてください。<div role="button"> と書いてもフォーカスやキー操作までは付いてこないので、結局 tabindex やキーイベントを手で足すはめになります。まず正しい要素。ARIA は、正しい要素が存在しない複雑な部品(タブ切り替えやツリー表示など)のための最後の手段です。
【手を動かす】マウスを封印して自分のアプリを一周する
#23 の買い物リストプロジェクトで、本文の e2e/keyboard.spec.ts を追加して実行してください。通ることを確認したら、ブラウザでも npm run dev で開いて、マウスに触らず Tab と Enter だけで品物を2つ追加してみます。フォーカスリングがどの要素を順に巡るか、目で追ってください。
次に App.vue の追加ボタンを本文の <div class="btn"> に差し替えて、テストが落ちることと、ブラウザで Tab がボタンに止まらなくなることを確かめます。確認したら <button> に戻します。
最後に contrast-check.mjs を手元に作って実行し、自分がこれまでの回で作った画面の文字色と背景色の組を pairs に足して、合否を測ってみてください。開発者ツールで要素を選択すると computed の color と background-color が確認できます。
確認テスト
知識問題
Q1. <div class="btn" @click="...">保存</div> に CSS で完璧なボタンの見た目を与えました。クリックすれば動きます。それでもこの実装が問題になる理由を、マウスを使わない利用者の視点で2つ説明してください。
解答を見る
1つ目、キーボードで到達できません。div はフォーカス可能な要素ではないので、Tab キーが素通りします(実測では、要素は存在するのにフォーカス状態が inactive のままでした)。キーボードだけで操作する人にとって、このボタンは画面に存在しないのと同じです。到達できたとしても、div は Enter / Space で押せません。
2つ目、何者なのか伝わりません。アクセシビリティツリーに role が載らないので、スクリーンリーダーは「保存」という文字としか読み上げず、それが押せるものだと利用者に伝わりません。
厄介なのは、マウスとクリックで使うぶんには完全に正常に動くことです。作った本人は気づけないので、「見た目はCSS、意味はHTML」という原則と、キーボードで一周する点検が必要になります。<button> に変えるだけで、到達・実行・読み上げの全部が標準装備されます。
Q2. アクセシビリティ対応は「利用者のごく一部のための追加コスト」だと言う同僚に、そうではないと説明してください。
解答を見る
反論の軸は2つあります。
1つ目、受益者は一部ではありません。駅のエレベーターが車椅子の人以外(ベビーカー、スーツケース、怪我人)にも使われるのと同じで、正しいセマンティクスとキーボード操作は、腱鞘炎の人、マウスの電池が切れた人、キーボード派のパワーユーザーを助けます。十分なコントラストは、屋外の直射日光の下でスマホを見る全員を助けます。障害は人だけでなく状況にも宿るので、全利用者が1日のどこかで受益者になります。
2つ目、追加コストというより品質の土台です。アクセシブルな画面は機械が意味を読める画面なので、テストが getByRole で安定して書け(#21)、検索エンジンにも内容が正しく伝わります。逆に div ボタンのような実装は、後から直すと差分もテストも大きくなります。最初から正しい要素を選ぶぶんには、コストはほぼゼロです。
Q3. ページ内で何かを実行する操作に <a>(リンク)を使い、別ページへの移動に <button> を使っているコードを見つけました。見た目はデザイン通りです。直すべきかどうか、理由とともに答えてください。
解答を見る
直すべきです。<a> は「別の場所へ移動する」、<button> は「その場で何かを実行する」という意味を機械と利用者に宣言する要素なので、逆に使うと宣言が嘘になります。
具体的な実害で言うと、スクリーンリーダーの利用者は「ページ内のリンク一覧」「ボタン一覧」という目次機能で画面を流し読みします。移動のはずの操作がボタンとして実装されていると、リンク一覧に出てきません。また、本物のリンクならできるはずの「新しいタブで開く」「URLをコピーする」といったブラウザ標準の操作も効かなくなります。キーボードの既定動作も異なります(リンクは Enter のみ、ボタンは Enter と Space)。
見た目は CSS でどちらにも寄せられるので、見た目を理由に要素を選ばない、が原則です(このシリーズでは「移動なら a、動作なら button」と覚えます)。
実技問題
Q4. 次の検索フォームは、スクリーンリーダーの利用者に入力欄の用途が伝わりません。問題点を指摘して直してください。直せたかどうかは、screen.getByLabelText("キーワード") で入力欄が見つかるかで判定できます。
<template>
<input v-model="q" placeholder="キーワード" />
<button>検索</button>
</template>
解答を見る
問題は、入力欄の説明が placeholder しかないことです。placeholder は入力した瞬間に消えるので、入力途中で「この欄は何だったか」を確認できません。薄い色で表示されるためコントラストも足りがちです。そもそも欄の名前ではなく「記入例」を見せるための属性です。
<label> を for と id で紐づけて直します(#23 の買い物リストと同じ形です)。
<template>
<label for="search">キーワード</label>
<input id="search" v-model="q" placeholder="例: 牛乳" />
<button>検索</button>
</template>
実測では、修正前は Unable to find a label with the text of: キーワード でテストが落ち、修正後は通りました。label を紐づけると、スクリーンリーダーが欄にフォーカスした瞬間に「キーワード」と読み上げるほか、label の文字をクリックしても欄にフォーカスが移るので、タッチ操作の当たり判定も広がります。placeholder は「例: 牛乳」のような記入例に戻してやると、両者の役割がきれいに分かれます。
Q5. あなたのチームのデザイン案では、白背景(#ffffff)に、本文が #555555、注釈が #999999 の文字色です。本文サイズの文字として両方を判定し、落ちる方を基準に通る色に直してください。本文の contrast-check.mjs が使えます。
解答を見る
pairs に2組を足して実行した結果がこれです(実測)。
#999999 on #ffffff 2.85:1 不合格
#555555 on #ffffff 7.46:1 AA合格
本文の #555555 は 7.46:1 で余裕の合格、注釈の #999999 は 2.85:1 で大きく不合格です。基準の 4.5:1 に対して6割しかありません。
直し方は注釈を濃くするだけです。たとえば #757575 にすると 4.61:1 で合格します(実測。本文で見たとおり #767676 が白背景でぎりぎり合格する境界なので、それより濃い色を選びます)。「注釈だから薄く」というデザインの意図は、色を薄くする以外にも、文字サイズを少し下げる、余白で本文と区切るなどの手段で表現できます。読めない文字は、どれだけ上品でも情報を運んでいません。
まとめ
- アクセシビリティは一部の人への特別対応ではなく、状況が変われば全員が受益者になる品質。機械可読性という形でテスト(getByRole)や検索エンジンにも効く
- ブラウザは DOM から「描画」と「アクセシビリティツリー」の2つを作る。見た目は CSS、意味は HTML でしか作れないので、要素は見た目でなく意味で選ぶ(移動は a、動作は button、入力欄には label)
- div ボタンはロールが無く Tab も素通りする。マウスでは正常に動くから気づけない。マウスを封印して Tab / Enter で一周する点検をリリース前に行う。フォーカスリングは消さない
- 本文のコントラスト比は 4.5:1 以上。目分量では判定できないので、開発者ツールやスクリプトで測る
- lint や axe で機械にも見張らせる。ARIA は正しい HTML 要素で表現できないときの最後の手段
次回から Part 6「Nuxt と本番」です。#26 Nuxt① では、ここまで素の Vue + Vite で作ってきた私たちが、なぜ Nuxt というフレームワークの上のフレームワークを使うのかから始めて、ファイルを置くだけでページが生えるルーティングと、画面の共通枠を作るレイアウトを手を動かして確かめます。
