useRouteAnnouncer (路由宣告器)

描述

一個組合式函式，用於監測頁面標題的變更並相應地更新宣告器訊息。由 <NuxtRouteAnnouncer> 使用且可控制。它hook into 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>