ツールチップのアクセシビリティの間違いを修正する
Fixing my tooltip accessibility mistake (jakearchibald.com)
要約
この記事は、開発者が作成したツールチップのアクセシビリティに関する間違いと、その修正方法について解説しています。当初、`aria-describedby`を使用してボタンとツールチップを関連付けましたが、これによりボタンのアクセシブルネームが失われ、スクリーンリーダーが正しく情報を伝えられませんでした。最終的に、`aria-labelledby`を使用することで、ボタンがツールチップから適切なアクセシブルネームを取得できるようになり、問題が解決したことが説明されています。
全文翻訳
ツールチップのアクセシビリティの間違いを修正する
私はアクセシビリティの誤りを犯しました。私の間違いから学んでほしいと思います。
最近、Firefoxに搭載されるWebプラットフォームの機能や、その他のWeb標準・開発に関する短い動画を作成しています。この記事の3分間の動画バージョンをご覧になりたい場合は、お使いのプラットフォームを選んで、興味があればアカウントをフォローしてください。
アカウントはBlueskyにもありますが、そこではしばらく動画のアップロードがうまくいっていません。
それ以外の場合は、こちらがテキストバージョンです…
私がやったこと
以下のようなツールチップを作成した際に、アクセシビリティの誤りを犯しました。
[画像: テキストフォーマットツールバー。太字、斜体、下線などのボタンがあります。マウスカーソルが「太字」ボタンの上に乗っており、ツールチップが表示されて「Bold (⌘B)」と表示されています。]
これはpopover="hint"に関する短い動画の一部で、視覚的なユーザーのためにツールチップを表示する方法もカバーしています。ああ、その動画へのリンクもここにあります。
私は正しくやろうとしました!アクセシビリティに詳しい友人に相談したところ、彼らはScott O'Haraによるデモを教えてくれました。
Scottは物事の専門家なので、彼のデモのパターンをそのままコピーできると思いました。Scottのデモはヒントポップオーバーよりも前に作られたものなので、彼の例のモダンなバージョンを以下に示します。
<button aria-describedby="edit-tooltip"> Edit</button><div id="edit-tooltip" popover="hint"> Modify account settings.</div>
<button aria-describedby="edit-tooltip">Edit</button><div id="edit-tooltip" popover="hint"> Modify account settings.</div>
<button aria-describedby="edit-tooltip">Edit</button><div id="edit-tooltip" popover="hint">Modify account settings.</div>
ボタンはaria-describedbyでツールチップに接続されているため、通常、ボタンがフォーカスされたときにスクリーンリーダーがツールチップを読み上げます。
aria-describedbyの良い点の一つは、それが指している要素が非表示の場合でも機能することです。このケースでは非表示になっています。
そこで、私のツールバーデモのためにScottのコードを適応させました。
<button aria-label="Bold" aria-describedby="bold-tooltip"> <svg>(bold icon)</svg></button><div id="bold-tooltip" popover="hint"> Bold (⌘B)</div>
<button aria-label="Bold" aria-describedby="bold-tooltip"> <svg>(bold icon)</svg></button><div id="bold-tooltip" popover="hint">Bold (⌘B)</div>
<button aria-label="Bold" aria-describedby="bold-tooltip"> <svg>(bold icon)</svg></button><div id="bold-tooltip" popover="hint">Bold (⌘B)</div>
これは非常に似たパターンですが、ボタンにはaria-labelを追加しました。なぜなら、ボタンにはテキストではなくSVGアイコンが含まれているからです。
Scottと同様に、ボタンとツールチップを接続するために、ボタンにaria-describedbyを追加しました。
VoiceOverでテストしたところ、「Bold. Bold. Command B. Button.」と読み上げられました。これは、あまり正しくないと思いました。なぜなら、「bold」と二度言う必要はないからです。
これは、Scottの例とは異なり、ツールチップに単に追加コンテンツが含まれているのではなく、私のツールチップにはラベルも含まれているために発生していました。Boldは、二度存在するため、二度言われました。
そこでaria-labelを削除しました…
<button aria-label="Bold" aria-describedby="bold-tooltip"><button aria-describedby="bold-tooltip"> <svg>(bold icon)</svg></button><div id="bold-tooltip" popover="hint">Bold (⌘B)</div>
…するとVoiceOverは「Clickable image. Bold. Command B. Button.」と読み上げるようになりました。これで良いと思いました!動画を公開し、パブに行きました。
どこで間違えたか
アクセシビリティエージェンシーTetraLogicalのLéonie WatsonとGez Lemonからメッセージを受け取り、非常に丁寧に、私が愚かなことをしたと伝えられました。
Scottのパターンは正しかったのですが、aria-labelを削除した際に私は道を誤りました。なぜなら、ボタンにはアクセシブル名がなくなってしまったからです。aria-describedbyは追加情報を提供するものであり、アクセシブル名の代わりにはなりません。
実際、WindowsのJAWSは、近くの要素からアクセシブルテキストを収集しようとし、結果として、イタリック体ツールチップ要素がDOMで兄弟であったため、ボタンを太字とイタリック体の両方としてアナウンスしました。
VoiceOverが「clickable image」と言ったとき、それはVoiceOverがアナウンスするアクセシブル名を持っていないことを示していました。その時は気づきませんでした。
修正方法
LéonieとGezは修正方法を教えてくれました。aria-describedbyからaria-labelledbyに変更しました。
<button aria-describedby="bold-tooltip"><button aria-labelledby="bold-tooltip"> <svg>(bold icon)</svg></button><div id="bold-tooltip" popover="hint">Bold (⌘B)</div>
aria-labelledbyはaria-describedbyのように機能しますが、追加の説明ではなく、アクセシブル名を提供します。
これでボタンはツールチップからアクセシブル名を取得し、VoiceOverは「Bold. Command B. Button.」と読み上げます。完璧です!
もし望むなら、これを分割することもできます。アクセシブル名は単に「Bold」で、追加の説明は「Command B」にするという具合です。
<button aria-labelledby="bold-label" aria-describedby="bold-description"> <svg>(bold icon)</svg></button><div id="bold-tooltip" popover="hint"> <span id="bold-label">Bold</span> <span id="bold-description"> (⌘B)</span> </div>
<button aria-labelledby="bold-label" aria-describedby="bold-description"> <svg>(bold icon)</svg></button><div id="bold-tooltip" popover="hint"> <span id="bold-label">Bold</span> <span id="bold-description">(⌘B)</span></div>
このケースではやりすぎだと思いますが、ツールチップに長い説明がある場合には意味があるかもしれません。
これで終わりです!インタラクティブな要素には常にアクセシブル名があることを確認してください。そして、可能であれば複数のスクリーンリーダーでテストしてください。一つのスクリーンリーダーでのテストは、一つのブラウザでのテストのようなものです。常に全体像を把握できるとは限りません。
修正されたデモはこちらですが、popover="hint"がまだサポートされていないSafariでは、うまく動作しません。