GT ClassMethodsLocales
getRegionProperties
Referencia de API del método getRegionProperties de GT
Descripción general
El método getRegionProperties obtiene información detallada sobre un código de región, incluido su name localizado y la bandera emoji asociada.
Ofrece una manera práctica de obtener información de presentación específica por región para crear interfaces de usuario internacionalizadas.
const gt = new GT({
sourceLocale: 'en-US',
targetLocale: 'fr-FR'
});
// Obtener propiedades de región
const usProps = gt.getRegionProperties('US');
console.log(usProps);
// { code: 'US', name: 'Estados Unidos', emoji: '🇺🇸' }
const frProps = gt.getRegionProperties('FR');
console.log(frProps);
// { code: 'FR', name: 'Francia', emoji: '🇫🇷' }
// Detección automática desde el locale actual
const currentRegion = gt.getRegionProperties(); // Usa la región del targetLocale
console.log(currentRegion);
// { code: 'FR', name: 'Francia', emoji: '🇫🇷' }Referencias
Parámetros
Prop
Type
Descripción de parámetros
| Parámetro | Descripción |
|---|---|
region | Código de región ISO 3166-1 alfa-2 o UN M.49. Si no se proporciona, utiliza la región del locale de destino de la instancia |
customMapping | Mapeo de región personalizado opcional para sobrescribir los nombres de región y los emoji predeterminados |
Devuelve
{ code: string; name: string; emoji: string } - Objeto que contiene:
code: Código de región de entradaname: Nombre de la región localizado en el idioma del locale de destinoemoji: Emoji de bandera o símbolo asociado
Ejemplos
Información básica de la región
const gt = new GT({
sourceLocale: 'en-US',
targetLocale: 'en-US'
});
// Códigos de región comunes
console.log(gt.getRegionProperties('US')); // { code: 'US', name: 'Estados Unidos', emoji: '🇺🇸' }
console.log(gt.getRegionProperties('GB')); // { code: 'GB', name: 'Reino Unido', emoji: '🇬🇧' }
console.log(gt.getRegionProperties('DE')); // { code: 'DE', name: 'Alemania', emoji: '🇩🇪' }
console.log(gt.getRegionProperties('JP')); // { code: 'JP', name: 'Japón', emoji: '🇯🇵' }Notas
- Utiliza la API
Intl.DisplayNamespara obtener nombres de región localizados - Admite códigos de región ISO 3166-1 alfa-2 y UN M.49
- Los mapeos personalizados reemplazan los nombres y los emojis predeterminados
- Detecta automáticamente la región a partir del locale de destino si no se proporciona ningún parámetro
- Si no se puede resolver el nombre para mostrar, usa el código de región como nombre
Próximos pasos
- Obtén todas las propiedades del locale con
getLocaleProperties - Obtén el emoji del locale con
getLocaleEmoji
¿Qué te ha parecido esta guía?