# 命令的な方法で支援技術に通知する `ariaNotify()` メソッド `ariaNotify()` メソッドは、支援技術を使用しているユーザーに対して、動的なコンテンツの更新を通知するための命令的な方法を提供する Web API です。従来の WAI-ARIA の仕様では `aria-label="xxx"` や `aria-checked="true"` のように宣言的な属性を使用して支援技術に情報を伝える方法が一般的でしたが、`ariaNotify()` メソッドは JavaScript を使用して、特定のタイミングで支援技術に通知を送ることができるという点が特徴です。 `ariaNotify()` メソッドは、以下のようなシナリオで使用されることが想定されています。 - チャットアプリで新しいメッセージが届いたときに通知する（特に、AI チャットのように生成が完了してから通知したい場合） - ビデオ会議アプリで、参加者が入室したときや退出したときに通知する - カートに商品を追加したとき、視覚に障害がないユーザーはカートのアイコンの変化で気づけるが、支援技術を使用しているユーザーには通知が必要 - 書式変更（Ctrl+B で太字にするなど）のように DOM の変更に紐づかないイベント - SPA（Single Page Application）で画面遷移したとき、新しいページの内容を支援技術に通知する従来は上記のようなユースケースで、開発者は `aria-live` 属性を持つ要素を DOM に追加して、支援技術に通知を送る方法が一般的でした。商品をカートに追加する例であれば、以下のようなコードが考えられます。 ```html ``` 上記のコードでは、`aria-live="polite"` を持つ要素を用意して、JavaScript の `announce` 関数で内容を更新することで、支援技術に通知を送っています。しかし、この方法はいくつかの問題がありました。 - 視覚的に非表示な要素を用意する必要や、ハックに頼った実装が必要であるなど、実装の複雑さが増す - DOM を更新してもその変更が支援技術に正しく伝わらない場合があった。たとえば、サイト全体で共通の live region を DOM の末尾に配置してシングルトン的に運用していると、モーダルダイアログを開いた状態では通知が届かないことがある。また live region の実装自体がブラウザやスクリーンリーダーで一貫しておらず、同じコードでも環境によって挙動が変わるという問題もある（詳細は [Improving Notification Handling with AriaNotify](https://www.w3.org/2025/Talks/aria-notify-breakouts-2025.pdf) を参照） - `polite` と `assertive` の通知のタイミングは支援技術の実装に依存しており、意図したタイミングで通知が行われないことがあった `ariaNotify()` メソッドは、これらの問題を解決するために設計されました。JavaScript を使用して、特定のタイミングで支援技術に通知を送ることができるため、より柔軟で確実な方法で動的なコンテンツの更新を伝えることができます。この記事では、`ariaNotify()` メソッドの使い方について、実装例や注意点を交えて解説していきます。 ## `ariaNotify()` メソッドの使い方 `ariaNotify()` メソッドは `Element.prototype` に定義されているため、任意の要素から呼び出すことができます。`Document` も `ParentNode` として同じインターフェイスを共有するため、以下のように `document` から呼び出すのが最も簡単です。 ```javascript document.ariaNotify("いぶきさんが入室しました。"); ``` このコードを実行すると、支援技術を使用しているユーザーに対して「いぶきさんが入室しました。」という通知が送られます。`ariaNotify()` メソッドは意図的に書き込み専用の API として設計されており、戻り値から通知が行われたかどうかを取得できません。これはフィンガープリントとして悪用されるのを防ぐための設計判断です。支援技術によっては複数回の `ariaNotify()` が行われたとき、順番に読み上げるものもありますが、保証されている仕様ではありません。通常は最新の通知のみが読み上げられるため、複数回呼び出すよりも 1 回呼び出す方が確実に通知が伝わります。 ```javascript // 連続して呼び出すと、最後の通知のみが読み上げられる可能性が高い document.ariaNotify("商品をカートに追加しました"); document.ariaNotify("3点。"); // 1 回の呼び出しでまとめる方が確実 document.ariaNotify("商品をカートに追加しました。3点。"); ``` :::warning 過剰に `ariaNotify()` を呼び出すと、支援技術を使用しているユーザーにとって煩わしい体験になる可能性があるため注意してください。 ::: ### 通知の優先度を指定する第 2 引数のオプションで、通知の優先度を指定できます。`priority: "high"` と `priority: "normal"`（デフォルト）の 2 種類があり、それぞれ `aria-live="assertive"` と `aria-live="polite"` とほぼ同等の意味になります。 ```javascript // 優先度を指定して通知する例 document.ariaNotify("エラーが発生したため、データが保存できませんでした。", { priority: "high", }); ``` :::warning `priority: "high"` を使用すると、ユーザーの操作を中断して通知が読み上げられる可能性があるため、重要な情報を伝える場合にのみ使用してください。ユーザーが頻繁に操作を中断されると、支援技術を使用しているユーザーにとってストレスになる可能性があります。 ::: ### 言語の選択支援技術が `ariaNotify()` で送られた通知を読み上げる際は、`` 要素の `lang` 属性を参照します（読み上げ時のアクセントや発音などに影響します）。もし `lang` 属性がない場合は、ユーザーのブラウザの言語設定を参照します。したがって、特定の言語で通知を読み上げたい場合は、適切に `lang` 属性を設定しておく必要があります。 ```html ... ``` ## カートに商品を追加する例 `ariaNotify()` メソッドを使用した具体的な例を見てみましょう。冒頭で説明した、商品をカートに追加する例を `ariaNotify()` を使って実装してみます。`aria-live` を使用した従来の方法と比較して、コードがシンプルになっていることがわかります。 ```html ``` macOS の VoiceOver を使用して試してみたところ、以下のように「カートに追加」ボタンをクリックしたタイミングで「商品をカートに追加しました。3 点。」と読み上げられることが確認できました（Chrome Canary 149 で動作を確認）。

## まとめ - `ariaNotify()` メソッドは、支援技術を使用しているユーザーに対して、動的なコンテンツの更新を通知するための命令的な方法を提供する Web API - 従来は `aria-live` 属性を持つ要素を DOM に追加して通知を送る方法が一般的だったが、この方法は実装の複雑さや通知のタイミングの不確実性などの問題があった - `ariaNotify()` メソッドは、JavaScript を使用して特定のタイミングで支援技術に通知を送ることができるため、よりシンプルなコードで通知を伝えることができる - 通知の優先度を指定できるが、過剰に使用するとユーザーにとって煩わしい体験になる可能性があるため注意が必要 ## 参考 - [Accessible Rich Internet Applications (WAI-ARIA) 1.3](https://w3c.github.io/aria/#ARIANotifyMixin) - [Element: ariaNotify() method - Web APIs | MDN](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaNotify) - [WICG/accessible-notifications: ARIA Accessible Notifications](https://github.com/WICG/accessible-notifications) - [Improving Notification Handling with AriaNotify](https://www.w3.org/2025/Talks/aria-notify-breakouts-2025.pdf) - [Understanding Success Criterion 4.1.3: Status Messages | WAI | W3C](https://www.w3.org/WAI/WCAG21/Understanding/status-messages.html) - [aria-live - ARIA | MDN](https://developer.mozilla.org/ja/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-live) - [ARIA Notifyについて - Speaker Deck](https://speakerdeck.com/ryokatsuse/aria-notifynituite)