useRouteAnnouncer

説明

ページタイトルの変更を観察し、それに応じてアナウンサーメッセージを更新するコンポーザブルです。<NuxtRouteAnnouncer>によって使用され、制御可能です。Unheadのdom:renderedにフックして、ページのタイトルを読み取り、アナウンサーメッセージとして設定します。

パラメーター

• politeness: スクリーンリーダーによるアナウンスの緊急度を設定します。 off（アナウンスを無効化）、polite（静寂を待ってからアナウンス）、またはassertive（すぐに割り込み）。（デフォルトはpolite）。

プロパティ

message

• 型: Ref<string>
• 説明: アナウンスするメッセージ

politeness

• 型: Ref<string>
• 説明: スクリーンリーダーのアナウンスの緊急度レベル off、polite、またはassertive

メソッド

set(message, politeness = "polite")

アナウンスするメッセージとその緊急度レベルを設定します。

polite(message)

politeness = "polite"でメッセージを設定します。

assertive(message)

politeness = "assertive"でメッセージを設定します。

例

<script setup lang="ts">
  const { message, politeness, set, polite, assertive } = useRouteAnnouncer({
    politeness: 'assertive'
  })
</script>