トピックを検索
1文字ずつに分けてアニメーションさせた見出し
1文字ずつ動くヒーローの見出しは文字ごとにinline-blockの要素で作られているため、Chromeからスクリーンリーダーには語ではなく文字がばらばらに渡ってしまう
<span class="char">週</span> 問題
スクリーンリーダーの利用者には、動く見出しが語の切れ目のない1文字ずつの並びとして届くため、ページでいちばん伝えたい言葉が文字の羅列になる
予定管理アプリのトップページは、濃い青のヒーローと大きな見出し「1週間の予定を数分で」から始まります。ページを開くと、見出しの文字が0.03秒ずつずれて、1文字ずつ下から浮かび上がります。1文字ずつ動かすために、アニメーションの前にスクリプトが見出しを分割しています。語を一つの要素にし、その中の文字もそれぞれ別の要素にして、動かしたり透明度を変えたりできるよう display: inline-block を指定します。Splitting.jsはこのマークアップを書き出し、推奨のスタイルシートで語と文字のそれぞれに display: inline-block を指定します。GSAPのSplitTextも、同じように文字をinline-blockにします。
目で見る人には、一つの文が見えます。ところが、ブラウザーが渡すものは違います。Chromeのアクセシビリティツリーでは、この見出しの名前は「1 週 間 の 予 定 を 数 分 で」で、1文字ごとにスペースが入ります。英語の見出しなら、語の切れ目もなくなります。ライブラリーの説明だけでなく、Chrome自身のツリーで確認しました。inline-blockのspanに入れた文字、語のボックスの中のinline-blockのdiv、フレックスの行に並べた普通のspanのどれでも、同じ文字の並びになりました。スクリーンリーダーは、ツリーから受け取ったものを読みます。スクリーンリーダーや設定によって、1文字ずつ読まれたり、音声エンジンが推測した音の並びになったりし、見出し一覧にも文字の並びとして出ます。
WCAG 1.3.2は、内容の順序が意味に影響する場合に、正しい読み上げ順序をコードから判断できることを求めています。語を作る文字の並びは、その最も小さな単位です。この例では、コードにはもう語がなく、ばらばらの文字の並びがあるだけです。W3Cの失敗例F32は、同じ結果を別の方法で起こす場合を挙げています。字間をあけるために語の文字の間にスペースを入力する場合です(スペースを入れて文字の間をあけた項目名や見出し)。そちらはスペースがテキストに入っています。こちらはテキストにスペースはありませんが、文字が1つずつ別のボックスになっていて、ブラウザーがボックスごとにテキストを分けて渡します。
決め手はレイアウトです。普通のインラインのspanに入れた文字は、まわりの語の一部のままです。インラインの文字で書いた見出しなら、Chromeが付ける名前は「1週間の予定を数分で」になります。文字を display: inline-block のボックスや、フレックスやグリッドの行のアイテムとして配置すると、Chromeはそれぞれを別のテキストとして扱い、語と語の間のスペースもなくなります。
見出しはたいていページの最初にあり、そのサイトが何のためのものかを伝える1行です。スクリーンリーダーの利用者にとっても、何より語として聞き取れなければならない行です。分割したリンクやボタンでは、影響はさらに大きくなります。リンク一覧に出る名前も、音声操作で押すときに言う名前も、文字の並びになるためです。
10グループ中3グループに影響
- 全盲 (影響あり)
- 弱視 (影響あり)
- 色覚 (影響なし)
- ろう (影響なし)
- 難聴 (影響なし)
- 発話 (影響なし)
- 手の操作 (影響なし)
- 筋力・可動域 (影響なし)
- 認知 (影響あり)
- 光過敏 (影響なし)
- 視覚を使わない 1文字ずつが別のテキストとしてスクリーンリーダーに届き、語の終わりも分からないため、見出しは1文字ずつ読まれたり、つづりとして読まれたりすることがあります。見出し一覧の項目も文字の並びになります。点字ディスプレイにも、同じ文字の並びが渡ります。
- 言語・認知・学習の能力が限られる ブラウザーのアクセシビリティツリーからページのテキストを取る読み上げツールにも同じ文字が渡るため、聞こえる言葉が画面の見出しと合いません。
- 視覚が限られる 画面拡大鏡の読み上げを使う人にも、スクリーンリーダーと同じ文字が届きます。
自動チェックから見ると、この見出しに問題はありません。見出しであり、テキストがあり、どの文字も実際のテキストで、コントラストも測れます。語がどう配置されているかを調べるaxeのルールはありません。axeがこの文字に触れるのは、一つの場合だけです。1文字だけのテキストは本当に文字なのか判断できないため、コントラストが足りない文字を失敗とはせず、「判断できなかったコントラスト」として挙げます。コントラストが足りていれば、文字はそのまま合格します。テンプレートを読むAIアシスタントには、ソースの 1週間の予定を数分で が見えるだけです。分割は、実行時にスクリプトが行います。EaseWebの診断は、表示されたページを読み、見出し、リンク、テキストのまとまりの中で1文字のボックスが3つ以上続く箇所を ew:split-letter-text として、Chromeが渡す文字の並びを引用して報告します。axeが判断できずに残した文字については、コントラストの確認が語ごとにまとめ、文字を消した画面写真から背景を測ります。
試してみる
画面の見出しと、スクリーンリーダーに渡る見出しを見比べてみましょう
「ボックスを表示」をオンにすると、アニメーションで動く要素のボックスに枠が付きます。ページの下には、Chromeが渡す見出しと、見出し一覧での見え方が出ます。続けて修正をそれぞれ適用し、見出しが動くままかどうか、スクリーンリーダーに語が渡るかどうかを確認してください。
問題あり 修正できますか?
1週間の予定を数分で
仕事も送り迎えも、その間の用事も、一つのカレンダーで。
スクリーンリーダーの読み上げ:
見出し、1 週 間 の 予 定 を 数 分 で
見出し一覧:
- 1 週 間 の 予 定 を 数 分 で
修正方法
スクリーンリーダーには語を渡し、読まれない側を動かす
<section class="hero"> <h1 class="hero-title"> <span class="word"> <span class="char" style="--char-index: 0">1</span> <span class="char" style="--char-index: 1">週</span> <span class="char" style="--char-index: 2">間</span> <span class="char" style="--char-index: 3">の</span> <span class="char" style="--char-index: 4">予</span> <span class="char" style="--char-index: 5">定</span> <span class="char" style="--char-index: 6">を</span> <span class="char" style="--char-index: 7">数</span> … </span> </h1></section>問題点3点
- 文字のそれぞれが、別のinline-blockの要素になっています。
- そのため、Chromeは見出しを「1 週 間 の 予 定 を 数 分 で」と、1文字ずつ区切った名前にします。
- 見出し一覧をはじめ、見出しのテキストを読むものには、同じ文字の並びが渡ります。
スクリーンリーダーには語を渡し、文字は隠す
<section class="hero"> <h1 class="hero-title"> <span class="visually-hidden">1週間の予定を数分で</span> <span class="letters" aria-hidden="true"> <span class="word"> <span class="char" style="--char-index: 0">1</span> <span class="char" style="--char-index: 1">週</span> <span class="char" style="--char-index: 2">間</span> <span class="char" style="--char-index: 3">の</span> <span class="char" style="--char-index: 4">予</span> <span class="char" style="--char-index: 5">定</span> <span class="char" style="--char-index: 6">を</span> <span class="char" style="--char-index: 7">数</span> … </span> </span> </h1></section>修正の手順2ステップ
- 見出しの中に、画面には出さず、スクリーンリーダーには残すテキストとして、語を1回だけ書きます。見出しの名前は「1週間の予定を数分で」になります。
- 文字を
aria-hidden="true"の要素で包み、その要素だけを分割します。スクリーンリーダーは文字を読み飛ばすため、語は1回だけ読まれます。
これで修正前の例は直り、見出し、リンク、段落のどの要素でも1.3.2を満たします。アニメーションは変わりません。語を2回書くことになるため、隠したテキストと文字は同じ文字列から作ってください。
見出しなら、3つとも基準を満たします。いちばん単純なのは語の単位で動かす方法です。隠すものも、2回書くものも、ARIAもなく、テキストがどの要素にあっても使えます。文字ではなく語が浮かび上がる見た目をデザインが受け入れられるなら、これを選びます。どうしても1文字ずつ動かしたい場合は、語を隠したテキストで書き、文字を aria-hidden の中に入れる方法を使います。段落や div の中のテキストを含め、どの要素でも使えます。見出しに名前を付ける方法は、すでにGSAPのSplitTextを使っているなら自動で書き出されるため最小の変更ですが、見出し、リンク、ボタンでしか成り立ちません。
どの方法も、文字を隠して初めて完成します。名前や隠したコピーだけを足して文字を残すと、スクリーンリーダーが読むものが2つになります。Chromeは見出しの名前を語にしますが、ページを読み進めると、文字も1つずつ残っています。文字は、包む要素か語のボックスごとに aria-hidden="true" で隠してください。見出しそのものに付けると、視覚的に隠したテキストまで読まれなくなるため、付けないでください。
使っているライブラリーが何を書き出すかを確認してください。Splitting.jsはARIAを付けません。GSAPのSplitTextは3.13から、標準の設定(aria オプションが "auto")で、分割した要素に aria-label を、行、語、文字のすべてに aria-hidden="true" を付けます。見出しなら上の3つ目の修正と同じで、p や div ならそこで説明した問題になります。GSAPのドキュメントは、自動で付く名前はテキストの中のリンクなどの要素を伝えないとし、その場合は隠したコピーを使うよう案内しています。リンクを含むテキストは、語に分けるか、分けずにおくほうが安全です。
日本語も同じように1文字ずつボックスになり、Chromeは1文字ずつ分けて渡します(「1 週 間 の 予 定」)。スペースを入れて文字の間をあけた項目名や見出しと同じく、1字だけで読まれた漢字は、語の中とは違う読み方になることがあります。
文字の動きそのものは別の話題です。ページの読み込みやスクロールで文字が浮かび上がったりフェードインしたりする動きは、動きを減らす設定がオンのときは止めておきます。上のどのコードでも、prefers-reduced-motion のメディアクエリーがその役目をしています。
修正の確認
3項目、マウス不要
確認方法: スクリーンリーダー
OS、ブラウザーと支援技術のバージョン、ビルド、実施日、各手順の実際の結果を記録してください。アニメーションやそのライブラリーを変更した際は、再度確認します。
制限
このサンプルは、どのアプリケーションでも同じ結果になることを保証するものではありません。対象は、アニメーションのためにスクリプトで文字に分割した見出しで、Chromeのアクセシビリティツリーで確認しました。ほかのブラウザーはツリーを独自の方法で作り、このガイドではスクリーンリーダーを試していません。文字をつづりとして読むか、音として読むか、一部をつなげて読むかは、スクリーンリーダー、その設定、音声エンジンによって異なります。行ごとに表示するために行単位で分割したテキストは語が残るため、ここでは扱いません。スペースを入力して字間をあけた語は、スペースを入れて文字の間をあけた項目名や見出しで扱っています。
よくある問題を再現した学習用のサンプルです。実在のクライアントの診断結果ではありません。コードは出発点となる実装例のため、実際の製品でも確認してください。ここでは支援技術でのテスト結果は報告していません。
参考資料
- WCAG Understanding: meaningful-sequence(新しいタブで開きます)
- WCAG Technique F32(新しいタブで開きます)
- w3.org: wai-aria-1.2(新しいタブで開きます)
- developer.mozilla.org: aria-hidden(新しいタブで開きます)
- splitting.js.org: guide(新しいタブで開きます)
- gsap.com: SplitText(新しいタブで開きます)
- gsap.com: a11y(新しいタブで開きます)
- css-irl.info: how-to-accessibly-split-text(新しいタブで開きます)
EaseWebのサービス
修正した問題を、次のリリースで再発させない
このガイドのような修正方法を、コーディングエージェントが従うルールと、CIのチェックに組み込みます。あわせて定期的に、キーボードとスクリーンリーダーで手動の再テストを行います。