Nuxt Nation 大会即将到来。加入我们,时间为 11 月 12 日至 13 日。

useRouteAnnouncer

此可组合函数观察页面标题的变化并相应地更新播报器消息。
此可组合函数在 Nuxt v3.12+ 中可用。

描述

一个可组合函数,用于观察页面标题的变化并相应地更新播报器消息。由 <NuxtRouteAnnouncer> 使用并可控制。它挂接到 Unhead 的 dom:rendered 以读取页面的标题并将其设置为播报器消息。

参数

  • politeness:设置屏幕阅读器公告的紧急程度:off(禁用公告)、polite(等待静音)或 assertive(立即中断)。(默认值为 polite)。

属性

message

  • 类型Ref<string>
  • 描述:要播报的消息

politeness

  • 类型Ref<string>
  • 描述:屏幕阅读器公告的紧急程度级别 offpoliteassertive

方法

set(message, politeness = "polite")

设置要播报的消息及其紧急程度级别。

polite(message)

使用 politeness = "polite" 设置消息

assertive(message)

使用 politeness = "assertive" 设置消息

示例

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