useLocale()

Aperçu

Le hook useLocale récupère la locale actuelle de l'utilisateur à partir du contexte <GTProvider>. La locale retournée est formatée en tant que chaîne, par exemple, 'en-US'.

Référence

Retours

Une chaîne représentant la locale actuelle de l'utilisateur, par exemple, 'en-US'.

Comportement de repli

Lorsqu'une locale non prise en charge est demandée, une locale de repli sera sélectionnée.

Par exemple, dans le cas d'une locale non prise en charge, si (1) l'utilisateur a configuré plusieurs locales préférées dans les paramètres de son navigateur, et (2) l'une de ces locales est prise en charge par votre application, alors la locale se repliera sur la meilleure langue.

De plus, si aucune locale de repli possible n'est disponible, mais que deux locales partagent la même langue (par exemple, en-US et en-GB), alors la locale se repliera sur la locale prise en charge qui partage la même langue.

Si aucune des conditions ne peut être remplie, alors la locale par défaut sera utilisée.

Voir <GTProvider> pour des informations sur la configuration des locales prises en charge.

Exemples

Utilisation de base

Récupérez la locale actuelle et affichez-la dans votre composant.

import { useLocale } from 'gt-react';
 
export default function CurrentLocale() {
    const locale = useLocale(); 
    return <p>Locale actuelle : {locale}</p>;
}

Notes

• Le hook useLocale() dépend de <GTProvider> pour accéder au contexte. Assurez-vous que votre application est enveloppée avec un fournisseur au niveau racine.
• En savoir plus sur les chaînes de localisation ici.

Prochaines étapes

• Apprenez à gérer et spécifier les locales prises en charge dans votre application avec gestion des locales.
• Pour accéder à la langue de secours, voir useDefaultLocale().