spAriaUtil: クライアント

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:1分
  • spAriaUtil API は、スクリーンリーダーにメッセージを表示するメソッドを提供します。

    この API は、 サービスポータル ウィジェットクライアントスクリプトで使用できる Angular サービスです。

    spAriaUtil - sendLiveMessage(文字列メッセージ)

    スクリーンリーダーにメッセージを読み上げます。

    sendLiveMessage() メソッドは、ページ上の aria-live 領域にテキストを挿入します。aria-live リージョンのデフォルト設定は アサティブです。つまり、メッセージはすぐにアナウンスされます。これを頻繁に使用すると、ユーザーを悩ませたり混乱させたりする可能性があります。

    表 : 1. パラメーター
    名前 タイプ 説明
    メッセージ 文字列 表示するメッセージ。
    表 : 2. 戻り値
    タイプ 説明
    なし
    function(spAriaUtil) {
      /* widget controller */
    
      spAriaUtil.sendLiveMessage('Hello world!');
    }