useLocale()

Descripción general

El hook useLocale recupera la configuración regional actual del usuario desde el contexto <GTProvider>. La configuración regional devuelta está formateada como una cadena, por ejemplo, 'en-US'.

Referencia

Devuelve

Una cadena que representa la configuración regional actual del usuario, por ejemplo, 'en-US'.

Comportamiento de reserva

Cuando se solicita una configuración regional no compatible, se seleccionará una configuración regional de reserva.

Por ejemplo, en caso de una configuración regional no compatible, si (1) el usuario ha configurado varias configuraciones regionales preferidas en la configuración de su navegador, y (2) una de estas configuraciones regionales es compatible con tu aplicación, entonces la configuración regional se ajustará al mejor idioma disponible.

Además, si no hay configuraciones regionales de reserva posibles disponibles, pero dos configuraciones regionales comparten el mismo idioma (por ejemplo, en-US y en-GB), entonces la configuración regional se ajustará a la configuración compatible que comparta el mismo idioma.

Si no se puede cumplir ninguna de estas condiciones, se utilizará la configuración regional predeterminada.

Consulta <GTProvider> para obtener información sobre cómo configurar las configuraciones regionales compatibles.

Ejemplos

Uso Básico

Recupera la configuración regional actual y muéstrala en tu componente.

import { useLocale } from 'gt-react';

export default function CurrentLocale() {
    const locale = useLocale(); 
    return <p>Current locale: {locale}</p>;
}

Notas

• El hook useLocale() depende del <GTProvider> para acceder al contexto. Asegúrate de que tu aplicación esté envuelta con un proveedor en el nivel raíz.
• Aprende más sobre las cadenas de configuración regional aquí.

Próximos Pasos

• Aprende cómo gestionar y especificar las configuraciones regionales compatibles en tu aplicación con el archivo gt.config.json.
• Para acceder al idioma de respaldo, consulta useDefaultLocale().