Pose una domanda e ottieni un riassunto del documento facendo riferimento a questa pagina e al provider AI di tua scelta
Il contenuto di questa pagina è stato tradotto con un'IA.
Vedi l'ultima versione del contenuto originale in ingleseSe hai un’idea per migliorare questa documentazione, non esitare a contribuire inviando una pull request su GitHub.
Collegamento GitHub alla documentazioneCopia il Markdown del documento nella porta-documenti
Hook useRewriteURL
Il hook useRewriteURL per Next.js è un hook lato client che gestisce automaticamente le riscritture degli URL localizzati. Garantisce che l'URL nel browser rifletta sempre il percorso localizzato "più leggibile" definito nel tuo intlayer.config.ts, anche se l'utente digita manualmente un percorso canonico con un prefisso di locale.
Questo hook opera silenziosamente usando window.history.replaceState, evitando navigazioni ridondanti tramite il router di Next.js o il ricaricamento della pagina.
Utilizzo
Richiama semplicemente l'hook in un Client Component che fa parte del tuo layout.
Come funziona
- Monitoraggio del percorso: L'hook ascolta i cambiamenti della
localedell'utente. - Rilevamento delle riscritture: Controlla l'attuale
window.location.pathnamerispetto alle regole di rewrite nella tua configurazione. - Correzione dell'URL: Se viene trovato un alias localizzato più leggibile per il percorso corrente, l'hook invoca
window.history.replaceStateper aggiornare la barra degli indirizzi mantenendo l'utente sulla stessa pagina interna.
Perché usarlo in Next.js?
Mentre il intlayerMiddleware gestisce le riscritture lato server e i reindirizzamenti iniziali, l'hook useRewriteURL garantisce che l'URL del browser rimanga coerente con la struttura SEO preferita anche dopo le transizioni lato client.
- URL puliti: Fa rispettare l'uso di segmenti localizzati come
/fr/essaisinvece di/fr/tests. - Prestazioni: Aggiorna la barra degli indirizzi senza scatenare un ciclo completo del router o riottenere i dati.
- Allineamento SEO: Previene problemi di contenuto duplicato assicurando che sia visibile una sola versione dell'URL all'utente e ai bot dei motori di ricerca.