Descripción general

El hook useLocale obtiene el locale actual del usuario del contexto de <GTProvider>. El locale devuelto se formatea como una cadena, p. ej., 'en-US'.

Referencia

Devuelve

Una cadena que representa el locale actual del usuario, por ejemplo, 'en-US'.

Comportamiento de fallback

Cuando se solicita un locale no admitido, se seleccionará un locale de fallback.

Por ejemplo, en el caso de un locale no admitido, si (1) el usuario ha configurado varios locales preferidos en la configuración del navegador, y (2) uno de esos locales es admitido por tu aplicación, entonces el locale hará fallback al mejor idioma.

Además, si no hay locales de fallback disponibles, pero dos locales comparten el mismo idioma (p. ej., en-US y en-GB), entonces el locale hará fallback al locale admitido que comparta ese idioma.

Si no se cumple ninguna de las condiciones, se usará el locale predeterminado.

Consulta <GTProvider> para obtener información sobre cómo configurar los locales admitidos.

Ejemplos

Uso básico

Obtén el locale actual y muéstralo en tu componente.

import { useLocale } from 'gt-react';

export default function CurrentLocale() {
    const locale = useLocale(); 
    return <p>Configuración regional actual: {locale}</p>;
}

Notas

• El hook useLocale depende de <GTProvider> para acceder al contexto. Asegúrate de envolver tu aplicación con un provider en el nivel raíz.
• Obtén más información sobre los códigos de configuración regional aquí.

Próximos pasos

• Aprende a gestionar y especificar las locales compatibles de tu aplicación con el archivo gt.config.json.