createNextMiddleware()

Übersicht

createNextMiddleware() ist eine Hilfsfunktion, die eine Middleware-Funktion für die Verwendung mit Next.js erstellt. Sie ermöglicht es Ihnen, für jede Sprache in Ihrer Next.js-Anwendung eine andere Route hinzuzufügen.

Zum Beispiel würde ein französischer Benutzer zu /fr/landing geleitet und ein englischer Benutzer zu /en/landing.

Für weitere Informationen zur Verwendung dieser Middleware siehe den i18n-Routing-Leitfaden.

Referenz

Requisiten

Prop	Type	Default
`pathConfig?`	`any`	`{}`
`localeRouting?`	`string`
`prefixDefaultLocale?`	`string \| number`	-

Beschreibung

Prop	Beschreibung
`pathConfig`	Ein verschachteltes Objekt, das lokalisierte Pfade für Ihre Anwendung angibt.
`localeRouting`	Eine Flagge, um i18n-Routing zu aktivieren oder zu deaktivieren.
`prefixDefaultLocale`	Eine Flagge, um das Entfernen des Sprachpräfixes von der Standardsprache zu aktivieren oder zu deaktivieren. (z.B. `/en/about` -> `/about`)

Beispiel

Grundlegende Verwendung

Fügen Sie einfach diese Funktion und den Pfad-Matcher zu Ihrer Middleware-Datei hinzu, um das Routing nach Lokalisierung zu aktivieren.

middleware.js

import { createNextMiddleware } from 'gt-next/middleware'
 
export default createNextMiddleware();
 
export const config = {
  matcher: [
    /*
      * Alle Anforderungspfade abgleichen, außer denen, die beginnen mit:
      * - api (API-Routen)
      * - _next (interne Dateien)
      * - statische Dateien
      */
    "/((?!api|static|.*\\..*|_next).*)",
  ],
}

Lokalisierte Pfade

Sie können lokalisierte Pfade über die Option pathConfig in der Middleware-Datei angeben.

middleware.js

export default createNextMiddleware({
  pathConfig: {
    "/about": "/about",
    "/airplanes": {
      "zh": "/飞机",
    }
  },
});

Siehe den i18n-Routing-Leitfaden für eine detaillierte Erklärung, wie dies funktioniert.

Entfernen des Standard-Lokalisierungspräfixes

Sie können das Standard-Lokalisierungspräfix entfernen, indem Sie die Option prefixDefaultLocale auf false setzen.

middleware.js

export default createNextMiddleware({
  prefixDefaultLocale: true,
});

Wenn dies wahr ist, muss jeder Pfad mit der Lokalisierung versehen werden. Wenn Sie dies auf false setzen (was der Standard ist), wird nur die Standard-Lokalisierung aus dem Pfad entfernt.

Notizen

Die Funktion createNextMiddleware() ist eine Hilfsfunktion, die eine Middleware-Funktion für die Verwendung mit Next.js erstellt.

Nächste Schritte

Siehe Anweisungen, wie man i18n-Routing zu Ihrer Next.js-Anwendung hinzufügt.

createNextMiddleware()

Auf dieser Seite