# アプリのメニューバーとして作られたナビゲーションメニュー

Source: https://easeweb.dev/learn/nav-menubar
Topics: メニューとナビゲーション > サイトのナビゲーションが、リンクとして読まれ、Tabで移動できる (WCAG 1.3.1)
The fix: ヘッダーをnav要素とリンクのリストで作り直し、サブメニューごとにaria-expanded付きのボタンを置いて、メニューのロールは使いません。最小限の変更なら、普通のリンクにrole="menuitem"を付けて、メニューバーの矢印キーの順に加えます。後者は1.3.1を満たしますが、サイトのナビゲーションがアプリのメニューとして動くままです。
Test with: screen reader, keyboard
References: https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html https://www.w3.org/TR/wai-aria-1.2/#menubar https://www.w3.org/WAI/ARIA/apg/patterns/menubar/ https://www.w3.org/WAI/ARIA/apg/patterns/menubar/examples/menubar-navigation/ https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/examples/disclosure-navigation/ https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/menu_role https://github.com/nvaccess/nvda/blob/master/source/browseMode.py https://www.radix-ui.com/primitives/docs/components/menubar https://www.radix-ui.com/primitives/docs/components/navigation-menu https://inclusive-components.design/menus-menu-buttons/

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

## 場面

あるお店のヘッダーに「ホーム」「ショップ」「読みもの」「ヘルプ」の四つの項目が並んでいます。「ショップ」と「ヘルプ」はページの一覧を開き、「ホーム」と「読みもの」は普通のリンクです。マウスで使う分には何も問題ありません。このヘッダーは、UIライブラリーがアプリの「ファイル」「編集」「表示」のメニュー用に用意しているメニューバーのコンポーネントで作られています。そのため「ショップ」と「ヘルプ」はメニュー項目になり、コンポーネントに対応する項目の種類がない「ホーム」と「読みもの」は、その横に普通のリンクとして置かれています。

スクリーンリーダーの利用者がTabキーでヘッダーに入ると、「ショップ」で「メニューバー、ショップ、メニュー項目、折りたたみ、2項目中1」と読まれます。四つの項目が見えるヘッダーなのに、項目は二つです。メニューバーの操作どおりに右矢印キーを押すと、「読みもの」を飛ばして「ヘルプ」の「2項目中2」に移ります。「ホーム」と「読みもの」もそこにあり、Tabキーでは届きますが、どちらもメニューの中の位置がない「リンク」として読まれます。聞こえる情報からは、二つの項目のメニューの横に、どこにも属さないリンクが二つあるとしか分かりません。

キーボードでも分かりにくさは同じです。コンポーネントはメニューバーにTabキーの止まる場所を一つだけ作り、最後に使ったメニュー項目に置きます。そのためTabキーは「ホーム」「ショップ」「読みもの」と進み、そのままページ本文へ抜けます。「ヘルプ」には「ショップ」から矢印キーで移るしかなく、右矢印キーを押すと「読みもの」は飛ばされます。

## 確認できる問題

達成基準1.3.1「情報及び関係性」は、画面で示している構造を支援技術も読み取れるよう求めています。画面では、四つの項目が一列に並んだ一つのメニューです。コードでは、`role="menubar"` がこの列をメニューバーだと伝えますが、ARIAではメニューバーが持てるのはメニュー項目（とそのグループや区切り）だけです。サブメニューの二つのボタンには `role="menuitem"` があるのでメニューバーの項目になりますが、「ホーム」と「読みもの」はリンクで、メニューバーが持てないロールのため、メニューバーの項目になりません。スクリーンリーダーはコードが示すとおりの構造を伝えます。二つの項目のメニューバー（2項目中1、2項目中2）と、その中にありながら数に入らない二つのリンクです。見えている人が受け取る「四つの項目の一つのメニュー」という関係は、ほかの人には伝わりません。

キー操作もこの構造に従います。メニューバーは、Tabキーで一度止まり、中を矢印キーで移動するものなので、コンポーネントはロービングtabindexを使い、一つのメニュー項目に `0`、もう一つに `-1` を設定します。リンクはそれぞれ今までどおりTabキーで止まり、矢印キーの順には入りません。「ヘルプ」も右矢印キーで届くため、すべての項目に届くという点では達成基準2.1.1「キーボード」を満たしますが、どのキーでどの項目に届くかが、項目ごとのマークアップの違いで決まってしまいます。

## 利用者への影響

メニューバーは、スクリーンリーダーの動きも変えます。たとえばNVDAは、フォーカスがメニューバーやメニュー項目に入るとすぐにフォーカスモードへ切り替え、矢印キーを自分の読み上げには使わず、ページのスクリプトに渡します。メニューバーがあるなら矢印キーはスクリプトが処理するはずなので、アプリの中と同じ扱いになるのです。

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

この例は、axeとLighthouseも報告します。メニューバーが `aria-required-children`、「特定のARIAロールには特定の子が含まれていなければなりません」に違反するためです。ただ、このメッセージはリンクにもナビゲーションにも触れず（詳細も「許可されていない子」として `a` 要素を挙げるだけです）、リストの問題のように読めます。すぐ思いつく直し方は、リンクに `role="menuitem"` を付けることです。AIのコーディングツールにこのエラーの修正を頼んでも、おそらくそうするでしょう。エラーは消え、ヘッダーはアプリのメニューバーとして完成します。これが後で紹介する二つ目の修正で、基準は満たし、axeも何も報告しませんが、サイトのナビゲーションとしては向いていない作りのままです。そもそもメニューバーを使うべきかどうかは、スキャンでは問われません。

EaseWebの診断では、メニューバーの中にメニュー項目でないリンクがあれば、axeのメッセージに代えて独自の指摘として報告し、該当するリンクの名前も示します。すべてのリンクがメニュー項目になっているメニューバーは、どの達成基準にも違反しないため、確認が必要な項目として挙げ、サイトのナビゲーションなのかアプリのメニューなのかを人が判断します。どちらの場合も、最後はスクリーンリーダーでヘッダーを聞き、Tabキーで移動して確かめます。

## 修正前：メニュー項目の横にリンクがあるメニューバー

```html
<header>
  <div class="menu" role="menubar">
    <a href="/" aria-current="page">ホーム</a>
    <button type="button" role="menuitem" aria-haspopup="menu" aria-expanded="false" aria-controls="shop-menu" tabindex="0">ショップ</button>
    <a href="/journal">読みもの</a>
    <button type="button" role="menuitem" aria-haspopup="menu" aria-expanded="false" aria-controls="help-menu" tabindex="-1">ヘルプ</button>
  </div>
  <div id="shop-menu" role="menu" aria-label="ショップ" hidden>
    <a href="/shop/lamps" role="menuitem" tabindex="-1">照明</a>
    <a href="/shop/chairs" role="menuitem" tabindex="-1">椅子</a>
    <a href="/shop/rugs" role="menuitem" tabindex="-1">ラグ</a>
  </div>
  <div id="help-menu" role="menu" aria-label="ヘルプ" hidden>
    …
  </div>
</header>
```

```js
// コンポーネントが書くメニューバーのキー操作：Tabキーの止まる場所は一つで、メニュー項目の間を
// 矢印キーで移動する。サブメニュー自体のキー操作（下矢印キーで開く、中での上下とEscape）は
// ここでは省略している。
const bar = document.querySelector('[role="menubar"]');
const items = [...bar.querySelectorAll('[role="menuitem"]')];

function move(to) {
  for (const item of items) item.tabIndex = -1;
  const item = items[(to + items.length) % items.length];
  item.tabIndex = 0;
  item.focus();
}

bar.addEventListener('keydown', (event) => {
  const at = items.indexOf(event.target);
  if (at < 0) return;
  if (event.key === 'ArrowRight') move(at + 1);
  if (event.key === 'ArrowLeft') move(at - 1);
});
```

- 「ホーム」と「読みもの」は、メニュー項目しか持てないメニューバーの中のリンクなので、メニューバーの項目になりません。スクリーンリーダーは項目を二つと数え、「ショップ」を2項目中1、「ヘルプ」を2項目中2と読みます。
- 右矢印キーは「ショップ」と「ヘルプ」の間だけを移動するため、「読みもの」を飛ばします。
- Tabキーは「ホーム」「ショップ」「読みもの」で止まりますが、右矢印キーで移動するまで `tabindex="-1"` の「ヘルプ」には止まりません。

## 修正後：リンクとサブメニューのボタンを持つnav

```html
<header>
  <nav aria-label="メイン">
    <ul class="menu">
      <li>
        <a href="/" aria-current="page">ホーム</a>
      </li>
      <li class="has-sub">
        <button type="button" aria-expanded="false" aria-controls="shop-menu">ショップ</button>
        <ul id="shop-menu" tabindex="-1" hidden>
          <li>
            <a href="/shop/lamps">照明</a>
          </li>
          <li>
            <a href="/shop/chairs">椅子</a>
          </li>
          <li>
            <a href="/shop/rugs">ラグ</a>
          </li>
        </ul>
      </li>
      <li>
        <a href="/journal">読みもの</a>
      </li>
      <li class="has-sub">
        <button type="button" aria-expanded="false" aria-controls="help-menu">ヘルプ</button>
        <ul id="help-menu" tabindex="-1" hidden>
          …
        </ul>
      </li>
    </ul>
  </nav>
</header>
```

```js
for (const item of document.querySelectorAll('.has-sub')) {
  const button = item.querySelector('button');
  const list = document.getElementById(button.getAttribute('aria-controls'));
  const setOpen = (open) => {
    button.setAttribute('aria-expanded', String(open));
    list.hidden = !open;
  };
  button.addEventListener('click', () => setOpen(list.hidden));
  item.addEventListener('keydown', (event) => {
    if (event.key === 'Escape' && !list.hidden) {
      setOpen(false);
      button.focus();
    }
  });
  // フォーカスが項目の外へ出たら閉じ、フォーカスは利用者が移した場所のままにする。
  item.addEventListener('focusout', (event) => {
    if (!item.contains(event.relatedTarget)) setOpen(false);
  });
}
```

1. メニューバーを、「メイン」という名前の `nav` に置き換え、中に項目ごとの `li` を持つリストを置きます。スクリーンリーダーはナビゲーションと四つの項目のリストを伝え、すべての項目がその中に入ります。
2. 「ホーム」と「読みもの」は普通のリンクのままにし、「ショップ」と「ヘルプ」は `role` も `aria-haspopup` も `tabindex` もない普通のボタンにします。どれも表示の順にTabキーで止まり、実際の役割のとおりに読まれます。
3. 各サブメニューの一覧をボタンのすぐ後に置き、ボタンの `aria-expanded` を一覧の `hidden` と合わせ、`aria-controls` で一覧を指します。Tabキーはボタンから開いた一覧の中へ進みます。
4. 開いた一覧は、Escapeキーでフォーカスをボタンに戻して閉じ、フォーカスが項目の外へ出たときにも閉じます。一覧に `tabindex="-1"` を付け、一覧の中をクリックしても外へ出たと見なされないようにします。
5. メニューバーのキー操作のスクリプトは削除します。ナビゲーションの移動はTabキーで足り、矢印キーは要りません。

これで修正前の問題が解消し、1.3.1を満たします。すべての項目がリストに入り、外れる項目はありません。ボタン、その開閉状態、二通りの閉じ方については、[マウスでしか開かないか、開閉が伝わらないドロップダウンメニュー](/ja/learn/nav-menus)で詳しく説明しています。

## 修正後：すべてのリンクをメニュー項目に

```html
<header>
  <div class="menu" role="menubar">
    <a href="/" role="menuitem" aria-current="page" tabindex="-1">ホーム</a>
    <button type="button" role="menuitem" aria-haspopup="menu" aria-expanded="false" aria-controls="shop-menu" tabindex="0">ショップ</button>
    <a href="/journal" role="menuitem" tabindex="-1">読みもの</a>
    <button type="button" role="menuitem" aria-haspopup="menu" aria-expanded="false" aria-controls="help-menu" tabindex="-1">ヘルプ</button>
  </div>
  <div id="shop-menu" role="menu" aria-label="ショップ" hidden>
    <a href="/shop/lamps" role="menuitem" tabindex="-1">照明</a>
    <a href="/shop/chairs" role="menuitem" tabindex="-1">椅子</a>
    <a href="/shop/rugs" role="menuitem" tabindex="-1">ラグ</a>
  </div>
  <div id="help-menu" role="menu" aria-label="ヘルプ" hidden>
    …
  </div>
</header>
```

```js
// コンポーネントが書くメニューバーのキー操作：Tabキーの止まる場所は一つで、メニュー項目の間を
// 矢印キーで移動する。サブメニュー自体のキー操作（下矢印キーで開く、中での上下とEscape）は
// ここでは省略している。
const bar = document.querySelector('[role="menubar"]');
const items = [...bar.querySelectorAll('[role="menuitem"]')];

function move(to) {
  for (const item of items) item.tabIndex = -1;
  const item = items[(to + items.length) % items.length];
  item.tabIndex = 0;
  item.focus();
}

bar.addEventListener('keydown', (event) => {
  const at = items.indexOf(event.target);
  if (at < 0) return;
  if (event.key === 'ArrowRight') move(at + 1);
  if (event.key === 'ArrowLeft') move(at - 1);
});
```

1. 「ホーム」と「読みもの」に `role="menuitem"` を付けます。メニューバーの項目になるため、スクリーンリーダーは項目を四つと数え、「ショップ」は4項目中2になります。
2. ほかの項目と同じく `tabindex="-1"` を付けます。スクリプトはもともとメニューバー内のすべてのメニュー項目を集めているため、矢印キーで四つすべてを移動できるようになり、メニューバーでTabキーが止まるのは一か所になります。

1.3.1を満たす最小限の変更で、axeのメッセージも消えます。ただし、ヘッダーがサイトのナビゲーションになるわけではありません。Tabキーで止まるのは一か所、移動は矢印キー、リンクは「メニュー項目」と読まれる、アプリのメニューバーとして完成しただけです。たとえばNVDAはメニューバーの中では矢印キーをページに渡すため、フォーカスがそこにある間、NVDAの利用者はページのほかの部分と同じようにメニューを文章として読めません。

## どの方法を選ぶか

navを使ってください。これだけで基準を満たし、覚えるキー操作もありません。すべての項目にTabキーで届き、リンクはリンクとして読まれ、リストが正しい項目数を伝えます。役割をすでに持つHTMLで作るため、メニューバーのキー操作のスクリプトは不要になり、残るボタンのスクリプトは[ドロップダウンメニューのガイド](/ja/learn/nav-menus)で紹介しているものと同じです。すべてのリンクをメニュー項目にする方法は、スキャンのエラーを手早く消せ、メニューバーとしては正しい作りですが、サイトのリンクを期待する人をアプリのメニューに置いたままにします。ARIA Authoring Practicesも、ナビゲーション用メニューバーの例のページで、ARIAのmenubarとmenuのロールに必要な追加のキー操作を必要とするサイトはほとんどないため、たいていのサイトには折りたたみウィジェットのパターンの方が向いていると書いています。メニューバーは、ページではなく「ファイル」「編集」のような操作を並べる、本当にアプリのメニューである場合だけに使います。

## 実装の判断

コンポーネントライブラリーは、たいてい両方を用意しています。Radix UIのMenubarは「デスクトップアプリによくある、常に表示されたメニュー」で、トリガーは `role="menuitem"` のボタンです。普通のリンクのための項目はないため、修正前の例のように、リンクがその横に置かれることになります。Navigation Menuは「Webサイトを移動するためのリンクの集まり」で、`nav`、リスト、サブメニュー用の `aria-expanded` 付きのボタンを出力し、ドキュメントにはmenubarと混同しないようにと書かれています。shadcn/uiにも、この二つを元にした同じ名前のコンポーネントがあります。ヘッダーがMenubarで作られているなら、リンクにロールを足すのではなく、コンポーネントを切り替えます。

ヘッダーのほかの部分にも、それぞれ判断が必要です。

- 矢印キー：なくてもかまいません。左右の矢印キーで上段の項目を移動できるようにしてもよいですが、各項目にはTabキーでも止まるようにし、矢印キーを知らない人が取りこぼさないようにします。
- `aria-haspopup`：サブメニューのボタンには付けません。ボタンに付けるとメニューを開くと伝わりますが、開くのはリンクの一覧です。
- 現在のページ：そのリンクの `aria-current="page"` は残します。詳しくは[現在のページを見た目だけで示すナビゲーション](/ja/learn/current-page)のガイドで説明しています。リスト内のリンクでも、メニューバーのときと同じように読まれます。
- ページでもありサブメニューも持つ項目：リンクと別のボタンを並べて置きます。[ページではなくサブメニューが開いてしまうドロップダウンの親メニュー](/ja/learn/menu-link-toggle)で扱っています。
- 同じページにある本当のアプリのメニュー、たとえばエディターの「ファイル」「編集」のメニューを並べたツールバーは、メニューバーのままでかまいません。「詳細」ボタンで開く操作のメニューは[開いたことが伝わらず、キーボードでは中に入れない操作メニュー](/ja/learn/menu-button)で扱っていて、そこでは `role="menu"` が正しい選択です。

## 修正の確認

1. ヘッダーを調べ、ナビゲーションとそのサブメニューに `role="menubar"`、`role="menu"`、`role="menuitem"` がなく、リンクとボタンに `tabindex` がないことを確認します。
2. マウスを使わず、ヘッダーの前から後ろまでTabキーで移動します。すべてのリンクとサブメニューのボタンに、表示の順で一度ずつ、矢印キーを使わずに届きます。
3. スクリーンリーダーでナビゲーションへTab移動して聞きます。ナビゲーションと、画面に見えているのと同じ項目数のリストが読まれ、リンクはリンクとして、サブメニューのボタンはボタンとして折りたたみの状態とともに読まれます。
4. 各サブメニューをEnterキーかSpaceキーで開きます。ボタンが展開と読まれ、Tabキーで中のリンクへ進め、Escapeキーで閉じるとフォーカスがボタンに戻ります。

OS、ブラウザー、支援技術のバージョン、ビルド、日付、各手順の実際の結果を記録します。共通のヘッダーのコンポーネントを変更したら、もう一度確認します。

## 制限

このガイドは、サイトのナビゲーションに付けるロールを扱います。マウスでしか開かないサブメニューや、一覧が開いているかどうかを伝えないボタンは、[マウスでしか開かないか、開閉が伝わらないドロップダウンメニュー](/ja/learn/nav-menus)で扱っています。スクリプトは、アニメーション、ホバーで開く動作、入れ子の階層を省いた最小限の例です。狭い画面用のメニューも含め、対象とする支援技術で一連の操作を確認してください。

---

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