Übersicht

createNextMiddleware ist eine Hilfsfunktion, die eine Middleware für die Verwendung mit Next.js erstellt. Sie ermöglicht es, für jede locale in Ihrer Next.js-Anwendung eine eigene Route bereitzustellen.

Zum Beispiel wird ein französischer Nutzer zu /fr/landing und ein englischer Nutzer zu /en/landing weitergeleitet.

Weitere Informationen zur Verwendung dieser Middleware finden Sie im i18n-Routing-Guide.

Referenz

Props

Beschreibung

Beispiel

Grundlegende Verwendung

Fügen Sie einfach diese Funktion und den Pfad-Matcher in Ihre Middleware-Datei ein, um das Locale-Routing zu aktivieren.

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 files)
      * - statische Dateien
      */
    "/((?!api|static|.*\\..*|_next).*)",
  ],
}

Lokalisierte Pfade

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

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

Siehe den i18n‑Routing‑Leitfaden für eine ausführliche Erklärung, wie das funktioniert.

Standardpräfix für die Standard‑Locale entfernen

Sie können das Standardpräfix für die Standard‑Locale entfernen, indem Sie die Option prefixDefaultLocale auf false setzen.

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

Wenn dies auf true gesetzt ist, muss jeder Pfad mit dem Locale präfixiert werden. Wenn du dies auf false setzt (Standard), wird nur das Standard-Locale aus dem Pfad entfernt.

Hinweise

• Die Funktion createNextMiddleware ist eine Hilfsfunktion, die eine Middleware für die Verwendung mit Next.js erzeugt.

Nächste Schritte