Intégration Next.js : Documentation du Hook useLocale pour next-intlayer

Cette section offre une documentation détaillée sur le hook useLocale conçu pour les applications Next.js au sein de la bibliothèque next-intlayer. Il est conçu pour gérer efficacement les changements de langue et le routage.

Importer useLocale dans Next.js

Pour utiliser le hook useLocale dans votre application Next.js, importez-le comme indiqué ci-dessous :

import { useLocale } from "next-intlayer"; // Utilisé pour gérer les langues et le routage dans Next.js

Utilisation

Voici comment implémenter le hook useLocale dans un composant Next.js :

"use client";import type { FC } from "react";import { Locales } from "intlayer";import { useLocale } from "next-intlayer";const LocaleSwitcher: FC = () => {  const { locale, defaultLocale, availableLocales, setLocale } = useLocale();  return (    <div>      <h1>Langue actuelle : {locale}</h1>      <p>Langue par défaut : {defaultLocale}</p>      <select value={locale} onChange={(e) => setLocale(e.target.value)}>        {availableLocales.map((loc) => (          <option key={loc} value={loc}>            {loc}          </option>        ))}      </select>    </div>  );};

Paramètres et valeurs de retour

Lorsque vous invoquez le hook useLocale, il retourne un objet contenant les propriétés suivantes :

• locale : La langue actuelle telle que définie dans le contexte React.
• defaultLocale : La langue principale définie dans la configuration.
• availableLocales : Une liste de toutes les langues disponibles telles que définies dans la configuration.
• setLocale : Une fonction pour changer la langue de l'application et mettre à jour l'URL en conséquence. Elle gère les règles de préfixe, que ce soit pour ajouter ou non la langue au chemin en fonction de la configuration. Utilise useRouter de next/navigation pour les fonctions de navigation comme push et refresh.
• pathWithoutLocale : Une propriété calculée qui retourne le chemin sans la langue. Elle est utile pour comparer les URLs. Par exemple, si la langue actuelle est fr, et l'URL est fr/my_path, le chemin sans langue est /my_path. Utilise usePathname de next/navigation pour obtenir le chemin actuel.

Conclusion

Le hook useLocale de next-intlayer est un outil essentiel pour gérer les langues dans les applications Next.js. Il offre une approche intégrée pour adapter votre application à plusieurs langues en gérant de manière transparente le stockage de la langue, la gestion de l'état et les modifications d'URL.

Historique de la documentation

• 5.5.10 - 2025-06-29 : Historique initial