Auteur:

Création:2026-01-21Dernière mise à jour:2026-01-21

Référencez cette doc à votre assistant AI préféréChatGPT Claude DeepSeek Google AI mode Gemini Perplexity Mistral Grok

Posez votre question et obtenez un résumé du document en referencant cette page et le Provider AI de votre choix

Ce document n'est pas à jour, la version de base a été mise à jour le 22 août 2026.

Aller à la doc anglaise

Historique des versions

"Ajout de l'utilitaire usePathname"
v10.0.023/06/2026
"Documentation unifiée pour toutes les exportations"
v8.0.021/01/2026

Le contenu de cette page a été traduit à l'aide d'une IA.

Voir la dernière version du contenu original en anglais

Modifier cette documentation

Si vous avez une idée d’amélioration pour améliorer cette documentation, n’hésitez pas à contribuer en submitant une pull request sur GitHub.

Lien GitHub de la documentation

Copier

Copier le Markdown du doc dans le presse-papiers

Package next-intlayer

Name: Intlayer
Rating: 4.92 (64 reviews)
Author: Intlayer

Le package next-intlayer fournit les outils nécessaires pour intégrer Intlayer dans des applications Next.js. Il prend en charge à la fois l'App Router et le Page Router, y compris le middleware pour le routage basé sur la locale.

Installation

bash

Copier le code

Copier le code dans le presse-papiers

npm install next-intlayer

Exportations

Middleware

Importer :

tsx

Copier le code

Copier le code dans le presse-papiers

import "next-intlayer/middleware";

Afficher tout le contenu du tableau

Ouvrir le tableau dans une fenêtre modale pour voir tout le contenu clairement

Fonction	Description	Documentation associée
`intlayerMiddleware`	Middleware Next.js pour gérer le routage et les redirections basés sur la locale. Détecte la locale à partir des en-têtes/cookies et redirige vers le chemin approprié pour la locale.	intlayerMiddleware

Helpers de configuration

Import:

tsx

Copier le code

Copier le code dans le presse-papiers

import "next-intlayer/server";

Afficher tout le contenu du tableau

Ouvrir le tableau dans une fenêtre modale pour voir tout le contenu clairement

Function	Description	Doc associée
`withIntlayer`	Helper asynchrone pour envelopper la configuration Next.js, garantissant que les dictionnaires Intlayer sont préparés avant la build. Prépare les fichiers de contenu et configure les plugins webpack/SWC.	-
`withIntlayerSync`	Helper synchrone pour envelopper la configuration Next.js, idéal pour les configurations où l'async n'est pas possible/souhaité. Ne prépare pas les dictionnaires au démarrage du serveur.	-

Fournisseurs

Importer :

tsx

Copier le code

Copier le code dans le presse-papiers

import "next-intlayer";

tsx

Copier le code

Copier le code dans le presse-papiers

import "next-intlayer/server";

Afficher tout le contenu du tableau

Ouvrir le tableau dans une fenêtre modale pour voir tout le contenu clairement

Composant	Description	Doc associée
`IntlayerClientProvider`	Provider pour les composants côté client dans le App Router de Next.js. Enveloppe `IntlayerProvider` de `react-intlayer`.	-
`IntlayerServerProvider`	Provider pour les composants côté serveur dans Next.js (App Router). Fournit le contexte de la locale sur le serveur.	-
`IntlayerServer`	Wrapper côté serveur pour le contenu Intlayer dans l'App Router. Assure une gestion appropriée des locales dans les Server Components.	-
`HTMLProvider`	Provider pour les paramètres d'internationalisation liés au HTML. Permet de surcharger les composants pour les balises HTML.	-
`HTMLRenderer`	Rend du contenu HTML avec des composants personnalisés.	-
`MarkdownProvider`	Provider pour le contexte de rendu markdown. Permet de remplacer des composants pour les éléments markdown.	-
`MarkdownRenderer`	Rend du contenu markdown avec des composants personnalisés.	-

Hooks (côté client)

Importer :

tsx

Copier le code

Copier le code dans le presse-papiers

import "next-intlayer";

Réexporte la plupart des hooks depuis react-intlayer.

Afficher tout le contenu du tableau

Ouvrir le tableau dans une fenêtre modale pour voir tout le contenu clairement

Hook	Description	Documentation associée
`useIntlayer`	Hook côté client qui sélectionne un dictionnaire par sa clé et retourne son contenu. Utilise la locale provenant du contexte si elle n'est pas fournie.	useIntlayer
`useDictionary`	Hook qui transforme un objet dictionnaire et retourne le contenu pour la locale courante. Traite les traductions `t()`, les énumérations, etc.	useDictionary
`useDictionaryAsync`	Hook qui gère des dictionnaires asynchrones. Accepte une map de dictionnaires basée sur des promesses et la résout pour la locale courante.	-
`useDictionaryDynamic`	Hook qui gère des dictionnaires dynamiques chargés par clé. Utilise React Suspense en interne pour les états de chargement.	-
`useLocale`	Hook côté client pour récupérer la locale courante et une fonction pour la définir. Amélioré pour Next.js App Router avec prise en charge de la navigation.	useLocale
`usePathname`	Retourne le chemin actuel sans le préfixe de la locale et sans les paramètres de requête de locale.	usePathname
`useRewriteURL`	Hook côté client pour gérer les réécritures d'URL. Met automatiquement à jour l'URL si une règle de réécriture localisée plus "propre" existe.	useRewriteURL
`useLocalePageRouter`	Hook spécifique au Page Router de Next.js pour la gestion des locales. Gère les redirections et les rechargements de page lors des changements de locale.	-
`useI18n`	Hook qui fournit une fonction de traduction `t()` pour accéder au contenu imbriqué par clé. Imite le pattern i18next/next-intl.	useI18n
`useIntl`	Hook qui fournit un objet `Intl` lié à la locale. Injecte automatiquement la locale courante et utilise une mise en cache optimisée.	-
`useLoadDynamic`	Hook pour charger des dictionnaires dynamiques en utilisant React Suspense. Accepte une clé et une promesse, met en cache les résultats.	-
`useHTMLRenderer`	Hook pour obtenir une fonction de rendu HTML préconfigurée.	-
`useMarkdownRenderer`	Hook pour obtenir une fonction de rendu Markdown préconfigurée.	-

Fonctions (côté serveur)

Import :

tsx

Copier le code

Copier le code dans le presse-papiers

import "next-intlayer/server";

Afficher tout le contenu du tableau

Ouvrir le tableau dans une fenêtre modale pour voir tout le contenu clairement

Fonction	Description	Documentation associée
`t`	Version côté serveur de la fonction de traduction pour l'App Router de Next.js. Renvoie la traduction du contenu multilingue pour la locale du serveur.	translation
`getLocale`	Fonction utilitaire pour extraire la locale courante depuis les en-têtes et cookies de Next.js. Conçue pour les Server Components, Server Actions ou Route Handlers.	-
`generateStaticParams`	Génère des paramètres statiques pour les routes dynamiques de Next.js en fonction des locales configurées. Renvoie un tableau d'objets de locale pour le pré-rendu.	-
`locale`	Fonction pour obtenir ou définir la locale dans le contexte serveur (App Router). Fournit la gestion des locales dans les Server Components.	-

Types

Importer :

tsx

Copier le code

Copier le code dans le presse-papiers

import "next-intlayer";

Afficher tout le contenu du tableau

Ouvrir le tableau dans une fenêtre modale pour voir tout le contenu clairement

Type	Description
`NextPageIntlayer`	Type pour les pages Next.js avec prise en charge d'Intlayer. Type générique incluant le paramètre locale.
`Next14PageIntlayer`	Type pour les pages Next.js 14 avec prise en charge d'Intlayer.
`Next15PageIntlayer`	Type pour les pages Next.js 15 avec prise en charge d'Intlayer.
`NextLayoutIntlayer`	Type pour les layouts Next.js avec prise en charge d'Intlayer. Type générique incluant le paramètre locale.
`Next14LayoutIntlayer`	Type pour les layouts Next.js 14 avec prise en charge d'Intlayer.
`Next15LayoutIntlayer`	Type pour les layouts Next.js 15 avec prise en charge d'Intlayer.
`LocalParams`	Type pour les paramètres de route Next.js comportant la locale. Objet avec la propriété `locale`.
`LocalPromiseParams`	Type pour les paramètres de route Next.js comportant la locale (version asynchrone). Promise qui résout en un objet avec la propriété `locale`.

useRewriteURL intlayerMiddleware