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
Prop | Type | Default |
---|---|---|
prefixDefaultLocale? | string | number | - |
localeRouting? | string |
|
pathConfig? | any | {} |
Beschreibung
Prop | Beschreibung |
---|---|
pathConfig | Ein verschachteltes Objekt, das lokalisierte Pfade für Ihre Anwendung angibt. |
localeRouting | Ein Schalter, um i18n-Routing zu aktivieren oder zu deaktivieren. |
prefixDefaultLocale | Ein 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.
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.
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.
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?