Middleware

createNextMiddleware()

API-Referenz für die Methode createNextMiddleware().

Übersicht

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

Zum Beispiel würde ein französischer Nutzer zu /fr/landing und ein englischer Nutzer zu /en/landing weitergeleitet werden.

Weitere Informationen zur Verwendung dieser Middleware findest du im i18n Routing Guide.

Referenz

Props

PropTypeDefault
prefixDefaultLocale?
string | number
-
localeRouting?
string
pathConfig?
any
{}

Beschreibung

PropBeschreibung
pathConfigEin verschachteltes Objekt, das lokalisierte Pfade für Ihre Anwendung angibt.
localeRoutingEin Schalter, um i18n-Routing zu aktivieren oder zu deaktivieren.
prefixDefaultLocaleEin Schalter, um das Entfernen des Locale-Präfixes von der Standard-Locale 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 die Locale-Routing-Funktion zu aktivieren.

middleware.js
import { createNextMiddleware } from 'gt-next/middleware'

export default createNextMiddleware();

export const config = {
  matcher: [
    /*
      * Alle Anfragen 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 die i18n Routing-Anleitung für eine ausführliche Erklärung, wie dies funktioniert.

Standard-Locale-Präfix entfernen

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

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

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


Hinweise

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

Nächste Schritte

  • Siehe Anleitung, wie du i18n-Routing zu deiner Next.js-Anwendung hinzufügst.

Wie ist dieser Leitfaden?