# 1文字ずつに分けてアニメーションさせた見出し

Source: https://easeweb.dev/learn/split-letter-text
Topics: ページの構造 > 読み上げ順序が見た目の順序と一致する (WCAG 1.3.2)
The fix: スクリーンリーダーには語を渡し、文字は隠します。語を視覚的に隠したテキストとして1回だけ書き、動かす文字はaria-hidden="true"の中に入れます。または、文字ではなく語の単位で動かします。見出し、リンク、ボタンなら、語をaria-labelに入れて文字を隠す方法も使えます。
Test with: screen reader
References: https://www.w3.org/WAI/WCAG22/Understanding/meaningful-sequence.html https://www.w3.org/WAI/WCAG22/Techniques/failures/F32 https://www.w3.org/TR/wai-aria-1.2/#namefromprohibited https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-hidden https://splitting.js.org/guide.html https://gsap.com/docs/v3/Plugins/SplitText/ https://gsap.com/resources/a11y/ https://css-irl.info/how-to-accessibly-split-text/

よくある問題を再現した学習用のサンプルです。実在のクライアントの診断結果ではありません。コードは出発点となる実装例のため、実際の製品でも確認してください。ここでは支援技術でのテスト結果は報告していません。

## 場面

予定管理アプリのトップページは、濃い青のヒーローと大きな見出し「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は、同じ結果を別の方法で起こす場合を挙げています。字間をあけるために語の文字の間にスペースを入力する場合です（[スペースを入れて文字の間をあけた項目名や見出し](/ja/learn/spaced-out-words)）。そちらはスペースがテキストに入っています。こちらはテキストにスペースはありませんが、文字が1つずつ別のボックスになっていて、ブラウザーがボックスごとにテキストを分けて渡します。

決め手はレイアウトです。普通のインラインのspanに入れた文字は、まわりの語の一部のままです。インラインの文字で書いた見出しなら、Chromeが付ける名前は「1週間の予定を数分で」になります。文字を `display: inline-block` のボックスや、フレックスやグリッドの行のアイテムとして配置すると、Chromeはそれぞれを別のテキストとして扱い、語と語の間のスペースもなくなります。

## 利用者への影響

見出しはたいていページの最初にあり、そのサイトが何のためのものかを伝える1行です。スクリーンリーダーの利用者にとっても、何より語として聞き取れなければならない行です。分割したリンクやボタンでは、影響はさらに大きくなります。リンク一覧に出る名前も、音声操作で押すときに言う名前も、文字の並びになるためです。

## 自動チェックとAIの限界

自動チェックから見ると、この見出しに問題はありません。見出しであり、テキストがあり、どの文字も実際のテキストで、コントラストも測れます。語がどう配置されているかを調べるaxeのルールはありません。axeがこの文字に触れるのは、一つの場合だけです。1文字だけのテキストは本当に文字なのか判断できないため、コントラストが足りない文字を失敗とはせず、「判断できなかったコントラスト」として挙げます。コントラストが足りていれば、文字はそのまま合格します。テンプレートを読むAIアシスタントには、ソースの `1週間の予定を数分で` が見えるだけです。分割は、実行時にスクリプトが行います。EaseWebの診断は、表示されたページを読み、見出し、リンク、テキストのまとまりの中で1文字のボックスが3つ以上続く箇所を `ew:split-letter-text` として、Chromeが渡す文字の並びを引用して報告します。axeが判断できずに残した文字については、コントラストの確認が語ごとにまとめ、文字を消した画面写真から背景を測ります。

## 修正前：文字のボックスに分割した見出し

```html
<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>
```

```css
.hero-title .word,
.hero-title .char {
  display: inline-block;
}
@media (prefers-reduced-motion: no-preference) {
  .hero-title .char {
    animation: rise 0.5s ease-out backwards;
    animation-delay: calc(var(--char-index) * 30ms);
  }
}
```

```js
Splitting({ target: '.hero-title', by: 'chars' });
```

- 文字のそれぞれが、別のinline-blockの要素になっています。
- そのため、Chromeは見出しを「1 週 間 の 予 定 を 数 分 で」と、1文字ずつ区切った名前にします。
- 見出し一覧をはじめ、見出しのテキストを読むものには、同じ文字の並びが渡ります。

## 修正後：スクリーンリーダーには語を渡し、文字は隠す

```html
<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>
```

```css
.hero-title .word,
.hero-title .char {
  display: inline-block;
}
@media (prefers-reduced-motion: no-preference) {
  .hero-title .char {
    animation: rise 0.5s ease-out backwards;
    animation-delay: calc(var(--char-index) * 30ms);
  }
}
.visually-hidden {
  position: absolute;
  width: 1px;
  height: 1px;
  overflow: hidden;
  clip-path: inset(50%);
  white-space: nowrap;
}
```

```js
Splitting({ target: '.hero-title .letters', by: 'chars' });
```

1. 見出しの中に、画面には出さず、スクリーンリーダーには残すテキストとして、語を1回だけ書きます。見出しの名前は「1週間の予定を数分で」になります。
2. 文字を `aria-hidden="true"` の要素で包み、その要素だけを分割します。スクリーンリーダーは文字を読み飛ばすため、語は1回だけ読まれます。

これで修正前の例は直り、見出し、リンク、段落のどの要素でも1.3.2を満たします。アニメーションは変わりません。語を2回書くことになるため、隠したテキストと文字は同じ文字列から作ってください。

## 修正後：語の単位で動かす

```html
<section class="hero">
  <h1 class="hero-title">
    <span class="word">1週間の</span>
    <span class="word">予定を</span>
    <span class="word">数分で</span>
  </h1>
</section>
```

```css
.hero-title .word {
  display: inline-block;
}
@media (prefers-reduced-motion: no-preference) {
  .hero-title .word {
    animation: rise 0.5s ease-out backwards;
    animation-delay: calc(var(--word-index) * 80ms);
  }
}
```

```js
// 日本語は語の間にスペースがなく、Splitting.jsの by: 'words' では分けられないため、
// 文節ごとのspanはマークアップに書き、アニメーションの順番だけを付ける
document.querySelectorAll('.hero-title .word').forEach((word, i) => word.style.setProperty('--word-index', i));
```

1. 見出しを文字ではなく文節に分け、それぞれをspanに入れます。日本語は語の間にスペースがないため、Splitting.jsの `by: 'words'` では分けられず、区切りはマークアップに書き、スクリプトはアニメーションの順番だけを付けます。Chromeが付ける名前は「1週間の 予定を 数分で」で、区切りが入るのは文節の間だけです。語の途中には入りません。
2. 文節を一つずつ順に動かします。

これで修正前の例は直り、隠したコピーもARIAも使わずに1.3.2を満たします。見た目は変わり、見出しは1文字ずつではなく文節ごとに浮かび上がります。

## 修正後：見出しに名前を付け、文字を隠す

```html
<section class="hero">
  <h1 class="hero-title" aria-label="1週間の予定を数分で">
    <span class="word" aria-hidden="true">
      <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>
```

```css
.hero-title .word,
.hero-title .char {
  display: inline-block;
}
@media (prefers-reduced-motion: no-preference) {
  .hero-title .char {
    animation: rise 0.5s ease-out backwards;
    animation-delay: calc(var(--char-index) * 30ms);
  }
}
```

```js
const title = document.querySelector('.hero-title');
title.setAttribute('aria-label', title.textContent.trim());
Splitting({ target: title, by: 'chars' });
title.querySelectorAll('.word').forEach((word) => word.setAttribute('aria-hidden', 'true'));
```

1. 分割する前に、見出しに語を入れた `aria-label` を付けます。見出しの名前は「1週間の予定を数分で」になります。
2. 語のボックスをすべて `aria-hidden="true"` で隠し、名前に加えて文字まで読まれないようにします。

見出し、リンク、ボタンなら1.3.2を満たします。GSAPのSplitTextがバージョン3.13から標準で行っている方法（`aria: "auto"` オプション）でもあります。ただし、それ以外の要素ではこれだけでは足りません。ARIAでは段落や `div` に名前を付けられないため、同じ分割をそこで行うと、スクリーンリーダーが読むテキストがなくなります。

## どの方法を選ぶか

見出しなら、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 週 間 の 予 定」）。[スペースを入れて文字の間をあけた項目名や見出し](/ja/learn/spaced-out-words)と同じく、1字だけで読まれた漢字は、語の中とは違う読み方になることがあります。

文字の動きそのものは別の話題です。ページの読み込みやスクロールで文字が浮かび上がったりフェードインしたりする動きは、動きを減らす設定がオンのときは止めておきます。上のどのコードでも、`prefers-reduced-motion` のメディアクエリーがその役目をしています。

## 修正の確認

1. スクリーンリーダーで、ページを上から下矢印キーで読む。動く見出しが、1文字ずつではなく、二重にもならず、語として1回だけ読まれるか確認する。
2. スクリーンリーダーの見出し一覧を開き、リンクを分割している場合はリンク一覧も開く。項目が、画面に書かれたとおりの語になっているか確認する。
3. ブラウザーの開発者ツールでアクセシビリティツリーを開き、見出しを選ぶ。名前が語と語の間にだけスペースのある語になっていて、文字が無視または非表示になっているか確認する。

OS、ブラウザーと支援技術のバージョン、ビルド、実施日、各手順の実際の結果を記録してください。アニメーションやそのライブラリーを変更した際は、再度確認します。

## 制限

このサンプルは、どのアプリケーションでも同じ結果になることを保証するものではありません。対象は、アニメーションのためにスクリプトで文字に分割した見出しで、Chromeのアクセシビリティツリーで確認しました。ほかのブラウザーはツリーを独自の方法で作り、このガイドではスクリーンリーダーを試していません。文字をつづりとして読むか、音として読むか、一部をつなげて読むかは、スクリーンリーダー、その設定、音声エンジンによって異なります。行ごとに表示するために行単位で分割したテキストは語が残るため、ここでは扱いません。スペースを入力して字間をあけた語は、[スペースを入れて文字の間をあけた項目名や見出し](/ja/learn/spaced-out-words)で扱っています。

---

このガイドをコーディングエージェントで使う: MCP https://easeweb.dev/mcp（設定は https://easeweb.dev/ja/services/developers）
