<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
)
このコンポーネントはオプションです。
完全なカスタマイズを実現するために、そのソースコードに基づいて独自のものを実装できます。
完全なカスタマイズを実現するために、そのソースコードに基づいて独自のものを実装できます。
useRouteAnnouncer
コンポーザブルを使用して、基になるアナウンサーインスタンスにフックすることができ、カスタムアナウンスメッセージを設定できます。