createNextMiddleware()

Aperçu

createNextMiddleware() est une fonction utilitaire qui crée une fonction middleware à utiliser avec Next.js. Elle vous permet d'ajouter une route différente pour chaque langue dans votre application Next.js.

Par exemple, un utilisateur français sera dirigé vers /fr/landing et un utilisateur anglais sera dirigé vers /en/landing.

Pour plus d'informations sur l'utilisation de ce middleware, consultez le guide de routage i18n.

Référence

Props

Description

Exemple

Utilisation de base

Il suffit d'ajouter cette fonction et le path matcher à votre fichier middleware pour activer le routage des locales.

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

export default createNextMiddleware();

export const config = {
  matcher: [
    /*
      * Correspond à tous les chemins de requête sauf ceux qui commencent par :
      * - api (routes API)
      * - _next (fichiers internes)
      * - fichiers statiques
      */
    "/((?!api|static|.*\\..*|_next).*)",
  ],
}

Chemins localisés

Vous pouvez spécifier des chemins localisés via l'option pathConfig dans le fichier middleware.

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

Consultez le guide de routage i18n pour une explication détaillée du fonctionnement.

Supprimer le préfixe de la locale par défaut

Vous pouvez supprimer le préfixe de la locale par défaut en définissant l'option prefixDefaultLocale sur false.

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

Lorsque cette option est activée, chaque chemin doit être préfixé par la locale. Si vous la définissez sur false (ce qui est la valeur par défaut), alors seule la locale par défaut sera supprimée du chemin.

Notes

• La fonction createNextMiddleware() est une fonction utilitaire qui crée une fonction middleware à utiliser avec Next.js.

Prochaines étapes

• Consultez les instructions pour savoir comment ajouter le routage i18n à votre application Next.js.