トピックを検索
アプリのメニューバーとして作られたナビゲーションメニュー
サイトのヘッダーがrole="menubar"で作られ、サブメニューのボタンはメニュー項目なのに普通のリンクはそうでないため、スクリーンリーダーがメニューの一部しか数えない
<div role="menubar"> 問題
スクリーンリーダーの利用者には、メニューの項目数が見た目より少なく伝わり、数から外れたリンクにはメニューの外でTabキーでしか届かない
あるお店のヘッダーに「ホーム」「ショップ」「読みもの」「ヘルプ」の四つの項目が並んでいます。「ショップ」と「ヘルプ」はページの一覧を開き、「ホーム」と「読みもの」は普通のリンクです。マウスで使う分には何も問題ありません。このヘッダーは、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は、フォーカスがメニューバーやメニュー項目に入るとすぐにフォーカスモードへ切り替え、矢印キーを自分の読み上げには使わず、ページのスクリプトに渡します。メニューバーがあるなら矢印キーはスクリプトが処理するはずなので、アプリの中と同じ扱いになるのです。
10グループ中2グループに影響
- 全盲 (影響あり)
- 弱視 (影響なし)
- 色覚 (影響なし)
- ろう (影響なし)
- 難聴 (影響なし)
- 発話 (影響なし)
- 手の操作 (影響あり)
- 筋力・可動域 (影響なし)
- 認知 (影響なし)
- 光過敏 (影響なし)
- 視覚を使わない スクリーンリーダーの利用者には、四つの項目が並ぶヘッダーなのに「ショップ、メニュー項目、2項目中1」と、二つの項目のメニューバーとして読まれます。「ホーム」と「読みもの」はメニューの外のリンクとして読まれ、矢印キーでメニューバーを移動しても届かないため、メニューの項目が実際より少ないように聞こえます。
- 手の操作が限られる キーボードの利用者は、Tabキーが「ホーム」「ショップ」「読みもの」では止まるのに「ヘルプ」には止まらないことに気づきます。「ヘルプ」には「ショップ」から矢印キーで移るしかなく、右矢印キーを押すと「読みもの」は飛ばされます。どのキーでどの項目に届くかは、画面のどこにも示されていません。
この例は、axeとLighthouseも報告します。メニューバーが aria-required-children、「特定のARIAロールには特定の子が含まれていなければなりません」に違反するためです。ただ、このメッセージはリンクにもナビゲーションにも触れず(詳細も「許可されていない子」として a 要素を挙げるだけです)、リストの問題のように読めます。すぐ思いつく直し方は、リンクに role="menuitem" を付けることです。AIのコーディングツールにこのエラーの修正を頼んでも、おそらくそうするでしょう。エラーは消え、ヘッダーはアプリのメニューバーとして完成します。これが後で紹介する二つ目の修正で、基準は満たし、axeも何も報告しませんが、サイトのナビゲーションとしては向いていない作りのままです。そもそもメニューバーを使うべきかどうかは、スキャンでは問われません。
EaseWebの診断では、メニューバーの中にメニュー項目でないリンクがあれば、axeのメッセージに代えて独自の指摘として報告し、該当するリンクの名前も示します。すべてのリンクがメニュー項目になっているメニューバーは、どの達成基準にも違反しないため、確認が必要な項目として挙げ、サイトのナビゲーションなのかアプリのメニューなのかを人が判断します。どちらの場合も、最後はスクリーンリーダーでヘッダーを聞き、Tabキーで移動して確かめます。
試してみる
Tabキーで、次に矢印キーでメニューを移動し、読み上げられる項目数を聞いてみましょう
Tabキーは「ホーム」「ショップ」「読みもの」で止まり、「ヘルプ」には止まりません。「ショップ」では下の欄に「2項目中1」と出ます。メニューバーが数えているのは「ショップ」と「ヘルプ」だけです。「ショップ」で右矢印キーを押すと、「読みもの」を飛ばして「ヘルプ」へ移ります。
修正を適用して、もう一度数えてみてください。
問題あり 修正できますか?
スクリーンリーダーの読み上げ:
(Tabでメニューへ移動)
修正方法
ナビゲーションはリンクにし、サブメニューにはボタンを置く
<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>問題点3点
- 「ホーム」と「読みもの」は、メニュー項目しか持てないメニューバーの中のリンクなので、メニューバーの項目になりません。スクリーンリーダーは項目を二つと数え、「ショップ」を2項目中1、「ヘルプ」を2項目中2と読みます。
- 右矢印キーは「ショップ」と「ヘルプ」の間だけを移動するため、「読みもの」を飛ばします。
- Tabキーは「ホーム」「ショップ」「読みもの」で止まりますが、右矢印キーで移動するまで
tabindex="-1"の「ヘルプ」には止まりません。
リンクとサブメニューのボタンを持つnav
<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>修正の手順5ステップ
- メニューバーを、「メイン」という名前の
navに置き換え、中に項目ごとのliを持つリストを置きます。スクリーンリーダーはナビゲーションと四つの項目のリストを伝え、すべての項目がその中に入ります。 - 「ホーム」と「読みもの」は普通のリンクのままにし、「ショップ」と「ヘルプ」は
roleもaria-haspopupもtabindexもない普通のボタンにします。どれも表示の順にTabキーで止まり、実際の役割のとおりに読まれます。 - 各サブメニューの一覧をボタンのすぐ後に置き、ボタンの
aria-expandedを一覧のhiddenと合わせ、aria-controlsで一覧を指します。Tabキーはボタンから開いた一覧の中へ進みます。 - 開いた一覧は、Escapeキーでフォーカスをボタンに戻して閉じ、フォーカスが項目の外へ出たときにも閉じます。一覧に
tabindex="-1"を付け、一覧の中をクリックしても外へ出たと見なされないようにします。 - メニューバーのキー操作のスクリプトは削除します。ナビゲーションの移動はTabキーで足り、矢印キーは要りません。
これで修正前の問題が解消し、1.3.1を満たします。すべての項目がリストに入り、外れる項目はありません。ボタン、その開閉状態、二通りの閉じ方については、マウスでしか開かないか、開閉が伝わらないドロップダウンメニューで詳しく説明しています。
この方法を選ぶ理由:まずHTMLの要素を使う
navを使ってください。これだけで基準を満たし、覚えるキー操作もありません。すべての項目にTabキーで届き、リンクはリンクとして読まれ、リストが正しい項目数を伝えます。役割をすでに持つHTMLで作るため、メニューバーのキー操作のスクリプトは不要になり、残るボタンのスクリプトはドロップダウンメニューのガイドで紹介しているものと同じです。すべてのリンクをメニュー項目にする方法は、スキャンのエラーを手早く消せ、メニューバーとしては正しい作りですが、サイトのリンクを期待する人をアプリのメニューに置いたままにします。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"は残します。詳しくは現在のページを見た目だけで示すナビゲーションのガイドで説明しています。リスト内のリンクでも、メニューバーのときと同じように読まれます。 - ページでもありサブメニューも持つ項目:リンクと別のボタンを並べて置きます。ページではなくサブメニューが開いてしまうドロップダウンの親メニューで扱っています。
- 同じページにある本当のアプリのメニュー、たとえばエディターの「ファイル」「編集」のメニューを並べたツールバーは、メニューバーのままでかまいません。「詳細」ボタンで開く操作のメニューは開いたことが伝わらず、キーボードでは中に入れない操作メニューで扱っていて、そこでは
role="menu"が正しい選択です。
修正の確認
4項目、マウス不要
確認方法: スクリーンリーダー、キーボード
OS、ブラウザー、支援技術のバージョン、ビルド、日付、各手順の実際の結果を記録します。共通のヘッダーのコンポーネントを変更したら、もう一度確認します。
制限
このガイドは、サイトのナビゲーションに付けるロールを扱います。マウスでしか開かないサブメニューや、一覧が開いているかどうかを伝えないボタンは、マウスでしか開かないか、開閉が伝わらないドロップダウンメニューで扱っています。スクリプトは、アニメーション、ホバーで開く動作、入れ子の階層を省いた最小限の例です。狭い画面用のメニューも含め、対象とする支援技術で一連の操作を確認してください。
よくある問題を再現した学習用のサンプルです。実在のクライアントの診断結果ではありません。コードは出発点となる実装例のため、実際の製品でも確認してください。ここでは支援技術でのテスト結果は報告していません。
参考資料
- WCAG Understanding: info-and-relationships(新しいタブで開きます)
- w3.org: wai-aria-1.2(新しいタブで開きます)
- ARIA APG: menubar(新しいタブで開きます)
- ARIA APG: menubar-navigation(新しいタブで開きます)
- ARIA APG: disclosure-navigation(新しいタブで開きます)
- developer.mozilla.org: menu_role(新しいタブで開きます)
- github.com: browseMode.py(新しいタブで開きます)
- radix-ui.com: menubar(新しいタブで開きます)
- radix-ui.com: navigation-menu(新しいタブで開きます)
- inclusive-components.design: menus-menu-buttons(新しいタブで開きます)
EaseWebのサービス
修正した問題を、次のリリースで再発させない
このガイドのような修正方法を、コーディングエージェントが従うルールと、CIのチェックに組み込みます。あわせて定期的に、キーボードとスクリーンリーダーで手動の再テストを行います。