Element: ariaNotify() メソッド

Baseline 2026

構文

ariaNotify(announcement)
ariaNotify(announcement, options)

引数

announcement

読み上げるテキストを指定する文字列。

options 省略可

以下のプロパティを含むオプションオブジェクトです。

priority

読み上げの優先度を指定する列挙値です。指定できる値は以下のとおりです。

normal: 読み上げは通常の優先度を持ちます。スクリーンリーダーが現在行っている読み上げの後に読み上げられます。これが既定値です。
high: 読み上げは高い優先度を持ちます。スクリーンリーダーが現在行っている読み上げに割り込んで、即座に読み上げられます。

解説

ariaNotify() メソッドは、プログラムからスクリーンリーダーの読み上げを発生させるために使用できます。このメソッドは ARIA ライブリージョンと似た機能を提供しますが、いくつかの利点があります。

ライブリージョンは DOM の変更後にしか読み上げを行えませんが、ariaNotify() の読み上げはいつでも発生させられます。
ライブリージョンの読み上げは変更された DOM ノードの更新後の内容を読み上げますが、ariaNotify() の読み上げ内容は DOM の内容とは独立して定義できます。

開発者は、ライブリージョンが設定された非表示の DOM ノードを用意し、読み上げたい内容でその内容を更新するという方法で、ライブリージョンの制限を回避することがよくあります。これは非効率的でエラーが起きやすく、ariaNotify() はこのような問題を避ける手段を提供します。

一部のスクリーンリーダーは複数の ariaNotify() の読み上げを順番に読み上げますが、これはすべてのスクリーンリーダーやプラットフォームで保証されるものではありません。通常は、直近の読み上げのみが発声されます。複数の読み上げを一つにまとめる方が信頼性が高くなります。

例えば、以下の呼び出しは、

elemRef.ariaNotify("Hello there.");
elemRef.ariaNotify("The time is now 8 o'clock.");

次のようにまとめたほうがよいでしょう。

elemRef.ariaNotify("Hello there. The time is now 8 o'clock.");

ariaNotify() の呼び出しは DOM 内のどの要素に対しても発生させられますが、ブラウザーがアクセシビリティ上「意味のある」要素とみなさず、アクセシビリティツリーの構築時に無視する要素は例外です。具体的にどの要素が無視されるかはブラウザーによって異なりますが、一般的には <html> 要素や <body> 要素のような、意味的な価値がほとんど、あるいはまったくないコンテナー要素が含まれます。

ariaNotify() の読み上げには Transient activation は必要ありません。ユーザー体験を損なわないよう、スクリーンリーダーの利用者に対して通知を送りすぎないように注意してください。

読み上げの優先度

priority: high が設定された ariaNotify() の読み上げは、priority: normal が設定された ariaNotify() の読み上げよりも先に読み上げられます。

ariaNotify() の読み上げは、おおよそ以下のように ARIA ライブリージョンの読み上げに相当します。

ariaNotify() の priority: high: aria-live="assertive"
ariaNotify() の priority: normal: aria-live="polite"

ただし、aria-live による読み上げは ariaNotify() の読み上げよりも優先されます。

<button>Press</button>

html,
body {
  height: 100%;
}

body {
  display: flex;
  justify-content: center;
  align-items: center;
}

document.querySelector("button").addEventListener("click", () => {
  document.querySelector("button").ariaNotify("You ain't seen me, right?");
});

結果

出力は以下のようになります。

スクリーンリーダーを起動してからボタンを押してみてください。スクリーンリーダーが "You ain't seen me, right?" と読み上げるはずです。

仕様書

仕様書
Accessible Rich Internet Applications (WAI-ARIA) # ARIANotifyMixin

ブラウザーの互換性

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって 2026年10月6日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告

Element: ariaNotify() メソッド

構文

引数

返値

解説

読み上げの優先度

言語の選択

パーミッションポリシーとの統合

例

`ariaNotify()` の基本的な使用方法

結果

仕様書

ブラウザーの互換性

関連情報

MDN の改良に協力