0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

35日でフロントエンドの基礎を完全に理解する #25 - アクセシビリティ

0
Posted at

この記事で学ぶこと

#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つ、アクセシビリティツリーという木も作っています。

ブラウザが作る2つの出力を示した図。HTML(書いたコード)から DOM(#1で学んだ木)が作られ、そこから2本の枝が出る。上の枝は画面への描画(見た目)で、ピクセルの色と位置、CSSで決まる。受け手は目で見る人で、マウスやタッチで操作する。下の枝はアクセシビリティツリー(意味)で、各要素の role(何者か)・名前・状態を持ち、HTMLの要素の選び方で決まる。受け手はスクリーンリーダーで聞く人、キーボードだけで操作する人、そして getByRole(#21)もこの木を見ている。CSSをどれだけ頑張っても届くのは上の枝だけで、下の枝は HTML の要素選びでしか作れない。下段は見た目が同じ「保存ボタン」を機械の目で見た対比。button要素+CSSは、role: button(ボタンだと伝わる)、名前「保存」、Tabで到達できる、Enter/Spaceで押せる、読み上げは「保存 ボタン」とすべて○。div+同じCSSは、roleなし(ただの箱と文字)、名前なし、Tabは素通りする、Enter/Spaceは効かない、読み上げは「保存」だけで押せると分からない、とすべて×。クリックは @click で動くのでマウスの人には違いが見えず、気づかれないまま壊れる

アクセシビリティツリーには、見た目の情報は入っていません。入っているのは各要素の意味です。role(ボタンなのか、見出しなのか、入力欄なのか)、名前(「保存」「品名」)、状態(押せるのか、チェック済みか)。スクリーンリーダーはこの木を読み上げ、キーボードのフォーカス移動もこの木の情報に従います。

ここで #21 の伏線を回収します。Testing Library の getByRole("button", { name: "保存" }) は、このアクセシビリティツリーから要素を探していました。だから「getByRole で見つかる画面はスクリーンリーダーでも操作しやすい」のです。同じ木を見ているのだから当然でした。

そして図の下に書いた一文が、この記事でいちばん大事な事実です。CSS がどれだけ頑張っても、届くのは見た目の枝だけ。意味の枝は、HTML の要素選びでしか作れません。

🔴 セマンティクス。意味は HTML でしか伝わらない

本当にそうなのか、機械の目で確かめます。CSS で完璧にボタンの見た目を与えた <div> を用意しました。クリックも @click で動きます。目で見るかぎり、本物のボタンと区別がつきません。

src/components/SaveButton.vue(見た目は完璧なボタン)
<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 を覚えたので、点検をテストコードにします。対象はおなじみの買い物リストです。

e2e/keyboard.spec.ts
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 で測定器を作って実測します。

contrast-check.mjs
// 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 というフレームワークの上のフレームワークを使うのかから始めて、ファイルを置くだけでページが生えるルーティングと、画面の共通枠を作るレイアウトを手を動かして確かめます。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?