createNextMiddleware
Riferimento API per il metodo createNextMiddleware().
Panoramica
createNextMiddleware è una funzione di utilità che genera un middleware da usare con Next.js.
Consente di aggiungere una route diversa per ogni lingua/locale nella tua applicazione Next.js.
Ad esempio, un utente francese verrebbe reindirizzato a /fr/landing e un utente inglese a /en/landing.
Per maggiori informazioni su come usare questo middleware, consulta la guida al routing i18n.
Riferimenti
Props
Prop
Type
Descrizione
| Prop | Descrizione |
|---|---|
pathConfig | Un oggetto annidato che definisce i percorsi localizzati dell’applicazione. |
localeRouting | Flag per abilitare o disabilitare il routing i18n. |
prefixDefaultLocale | Flag per abilitare o disabilitare la rimozione del prefisso della lingua dalla locale predefinita (es. /en/about -> /about). |
Esempio
Utilizzo di base
Invoca questa funzione e aggiungi il path matcher al file middleware per abilitare il routing delle lingue.
import { createNextMiddleware } from 'gt-next/middleware'
export default createNextMiddleware();
export const config = {
matcher: [
/*
* Intercetta tutti i percorsi delle richieste, tranne quelli che iniziano con:
* - api (route API)
* - _next (file interni)
* - file statici
*/
"/((?!api|static|.*\\..*|_next).*)",
],
}Percorsi localizzati
Puoi specificare i percorsi localizzati tramite l'opzione pathConfig nel file del middleware.
export default createNextMiddleware({
pathConfig: {
"/about": "/about",
"/airplanes": {
"zh": "/飞机",
}
},
});Consulta la guida al routing i18n per una spiegazione dettagliata su come funziona.
Rimuovere il prefisso della locale predefinita
Puoi rimuovere il prefisso della locale predefinita impostando l’opzione prefixDefaultLocale su false.
export default createNextMiddleware({
prefixDefaultLocale: true,
});Quando è impostato su true, ogni percorso deve essere preceduto dal codice locale.
Se lo imposti su false (impostazione predefinita), verrà rimosso dal percorso solo il codice della locale predefinita.
Note
- La funzione
createNextMiddlewareè un’utility che genera una funzione middleware da utilizzare con Next.js.
Prossimi passi
Come valuti questa guida?