<NuxtRouteAnnouncer>
<NuxtRouteAnnouncer> コンポーネントは、ルート変更を支援技術に知らせるためにページタイトルを持つ隠し要素を追加します。
このコンポーネントは Nuxt v3.12+ で利用可能です。
使用法
<NuxtRouteAnnouncer/>
を app.vue
または app/layouts/
に追加して、支援技術にページタイトルの変更を知らせることでアクセシビリティを向上させます。これにより、スクリーンリーダーに依存するユーザーにナビゲーションの変更が通知されます。
app/app.vue
<template>
<NuxtRouteAnnouncer />
<NuxtLayout>
<NuxtPage />
</NuxtLayout>
</template>
スロット
ルートアナウンサーのデフォルトスロットを通じてカスタムHTMLやコンポーネントを渡すことができます。
<template>
<NuxtRouteAnnouncer>
<template #default="{ message }">
<p>{{ message }} was loaded.</p>
</template>
</NuxtRouteAnnouncer>
</template>
プロップ
atomic
: スクリーンリーダーが変更のみをアナウンスするか、全コンテンツをアナウンスするかを制御します。更新時に全コンテンツを読み上げるには true に設定し、変更のみの場合は false に設定します。(デフォルトはfalse
)politeness
: スクリーンリーダーのアナウンスの緊急度を設定します:off
(アナウンスを無効にする)、polite
(静寂を待つ)、またはassertive
(即座に中断する)。(デフォルトはpolite
)
このコンポーネントはオプションです。 :br 完全なカスタマイズを達成するために、ソースコードに基づいて独自のものを実装することができます。
useRouteAnnouncer
composable を使用して、基盤となるアナウンサーインスタンスにフックし、カスタムアナウンスメッセージを設定することができます。
※このページは Nuxt.js 公式ドキュメントの翻訳ページ(非公式)です。
公式ドキュメントの該当ページはこちら:
https://nuxt.com/docs/4.x/api/components/nuxt-route-announcer