nuxt logo

Traducción de Documentación (No Oficial)

<NuxtRouteAnnouncer>

El componente <NuxtRouteAnnouncer> añade un elemento oculto con el título de la página para anunciar cambios de ruta a las tecnologías de asistencia.

Este componente está disponible en Nuxt v3.12+.

Uso

Añade <NuxtRouteAnnouncer/> en tu app.vue o layouts/ para mejorar la accesibilidad informando a las tecnologías de asistencia sobre los cambios en el título de la página. Esto asegura que los cambios de navegación se anuncien a los usuarios que dependen de lectores de pantalla.

app.vue
<template>
  <NuxtRouteAnnouncer />
  <NuxtLayout>
    <NuxtPage />
  </NuxtLayout>
</template>

Slots

Puedes pasar HTML personalizado o componentes a través del slot predeterminado del anunciador de rutas.

  <template>
    <NuxtRouteAnnouncer>
      <template #default="{ message }">
        <p>{{ message }} fue cargado.</p>
      </template>
    </NuxtRouteAnnouncer>
  </template>

Props

  • atomic: Controla si los lectores de pantalla solo anuncian cambios o todo el contenido. Establece en true para lecturas completas del contenido en actualizaciones, false solo para cambios. (por defecto false)
  • politeness: Establece la urgencia para los anuncios del lector de pantalla: off (desactiva el anuncio), polite (espera a que haya silencio), o assertive (interrumpe inmediatamente). (por defecto polite)

Este componente es opcional. :br Para lograr una personalización completa, puedes implementar uno propio basado en su código fuente.

Puedes conectarte a la instancia subyacente del anunciador usando el composable useRouteAnnouncer, lo que te permite establecer un mensaje de anuncio personalizado.