<NuxtRouteAnnouncer>
<NuxtRouteAnnouncer> コンポーネントは、ルート変更を支援技術に知らせるためにページタイトルを持つ隠し要素を追加します。
このコンポーネントは Nuxt v3.12+ で利用可能です。
使用方法
<NuxtRouteAnnouncer/>
を app.vue
または layouts/
に追加して、支援技術にページタイトルの変更を知らせることでアクセシビリティを向上させます。これにより、スクリーンリーダーに依存するユーザーにナビゲーションの変更が通知されます。
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/3.x/api/components/nuxt-route-announcer