nuxt logo

Tradução da Documentação (Não Oficial)

<NuxtRouteAnnouncer>

O componente <NuxtRouteAnnouncer> adiciona um elemento oculto com o título da página para anunciar mudanças de rota a tecnologias assistivas.

Este componente está disponível no Nuxt v3.12+.

Uso

Adicione <NuxtRouteAnnouncer/> no seu app.vue ou layouts/ para melhorar a acessibilidade informando as tecnologias assistivas sobre mudanças no título da página. Isso garante que as mudanças de navegação sejam anunciadas para usuários que dependem de leitores de tela.

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

Slots

Você pode passar HTML personalizado ou componentes através do slot padrão do anunciador de rota.

  <template>
    <NuxtRouteAnnouncer>
      <template #default="{ message }">
        <p>{{ message }} foi carregado.</p>
      </template>
    </NuxtRouteAnnouncer>
  </template>

Props

  • atomic: Controla se os leitores de tela anunciam apenas mudanças ou todo o conteúdo. Defina como true para leituras completas de conteúdo em atualizações, false apenas para mudanças. (padrão false)
  • politeness: Define a urgência para anúncios de leitores de tela: off (desativa o anúncio), polite (espera por silêncio) ou assertive (interrompe imediatamente). (padrão polite)

Este componente é opcional. :br Para obter personalização completa, você pode implementar o seu próprio baseado no código fonte.

Você pode se conectar à instância subjacente do anunciador usando o composable useRouteAnnouncer, que permite definir uma mensagem de anúncio personalizada.