Middleware

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

PropDescrizione
pathConfigUn oggetto annidato che definisce i percorsi localizzati dell’applicazione.
localeRoutingFlag per abilitare o disabilitare il routing i18n.
prefixDefaultLocaleFlag 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.

middleware.js
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.

middleware.js
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.

middleware.js
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?

createNextMiddleware