Überblick

createNextMiddleware ist eine Hilfsfunktion, die eine Middleware-Funktion für die Verwendung mit Next.js erstellt. Damit können Sie Ihrer Next.js-Anwendung für jedes Locale eine eigene Route hinzufügen.

Beispielsweise 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‑Leitfaden.

Referenz

Props

Beschreibung

Beispiel

Grundlegende Verwendung

Fügen Sie einfach diese Funktion und den Pfad-Matcher zu Ihrer Middleware-Datei hinzu, 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 Dateien)
      * - 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 Leitfaden zum i18n‑Routing für eine ausführliche Erklärung, wie das funktioniert.

Präfix der Standard-Locale entfernen

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

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

Wenn dieser Wert auf true steht, muss jeder Pfad mit der locale beginnen. Wenn du ihn auf false setzt (Standard), wird nur die Standard-locale aus dem Pfad entfernt.

Hinweise

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

Nächste Schritte