GT ClassMethodsLocales
determineLocale
Referencia de API del método determineLocale de GT
Descripción general
El método determineLocale determina la mejor coincidencia de locale a partir de una lista de locales aprobadas según las preferencias del usuario.
Implementa negociación de locale para encontrar la locale más adecuada cuando no hay coincidencias exactas disponibles.
const gt = new GT({
sourceLocale: 'en-US',
locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});
// Coincidencia exacta
console.log(gt.determineLocale('en-US')); // 'en-US'
// Respaldo por idioma
console.log(gt.determineLocale('en-GB')); // 'en-US' (variante de inglés más cercana)
// Múltiples preferencias
console.log(gt.determineLocale(['fr-CA', 'es-MX', 'en-US'])); // 'es-ES' (español más cercano)
// Sin coincidencia
console.log(gt.determineLocale('it-IT')); // undefinedReferencia
Parámetros
Prop
Type
Devuelve
string | undefined - El locale que mejor coincide o undefined si no se encuentra ninguna coincidencia
Ejemplos
Negociación del locale del usuario
const gt = new GT({
sourceLocale: 'en-US',
locales: ['en-US', 'en-GB', 'es-ES', 'fr-FR']
});
// Simular el encabezado Accept-Language del navegador
const userPreferences = ['fr-CA', 'en-GB', 'en'];
const bestMatch = gt.determineLocale(userPreferences);
console.log(bestMatch); // 'fr-FR' según el orden de preferenciaNotas
- Devuelve la primera coincidencia exacta entre las locales aprobadas
- Recurre a coincidencias por idioma cuando la región exacta no está disponible
- Respeta el orden de preferencia en el array de entrada
- Devuelve undefined cuando no se encuentra ninguna coincidencia adecuada
- Es esencial para implementar la negociación de locale en aplicaciones web
Próximos pasos
- Revisa las necesidades de traducción con
requires-translation - Compara los idiomas con
is-same-language
¿Qué te ha parecido esta guía?