GT ClassMethodsLocales

getLocaleProperties

Referencia de API del método getLocaleProperties de GT

Descripción general

El método getLocaleProperties obtiene propiedades completas para un código de configuración regional, proporcionando información detallada que incluye nombres de visualización, códigos de región, información de escritura y banderas emoji. Devuelve un objeto LocaleProperties con todos los datos necesarios para crear interfaces de usuario internacionalizadas completas.

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});

const props = gt.getLocaleProperties('fr-CA');
console.log(props.name); // "Francés (Canadá)"
console.log(props.nativeName); // "français (Canada)"
console.log(props.emoji); // "🇨🇦"

Referencias

Parámetros

Prop

Type

Descripción de parámetros

ParámetroDescripción
localeCódigo de configuración regional BCP-47 para obtener las propiedades. Si no se proporciona, utiliza el targetLocale de la instancia

Devuelve

LocaleProperties - Un objeto completo que contiene toda la información de la configuración regional:

  • code: Código de configuración regional estandarizado
  • name: Nombre para mostrar en la configuración regional de origen
  • nativeName: Nombre para mostrar en la propia configuración regional
  • languageCode, languageName, nativeLanguageName: Información del idioma
  • regionCode, regionName, nativeRegionName: Información de la región
  • scriptCode, scriptName, nativeScriptName: Información del sistema de escritura
  • maximizedCode, minimizedCode: Formas canónicas
  • nameWithRegionCode, nativeNameWithRegionCode: Formatos de visualización combinados
  • emoji: Bandera o emoji representativo

Genera

  • Error - Si no se proporciona un locale y la instancia no tiene targetLocale configurado

Ejemplos

Uso básico

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'fr'
});

// Obtener propiedades del target locale
const props = gt.getLocaleProperties();
console.log(props.name); // "French (France)"
console.log(props.nativeName); // "français (France)"
console.log(props.languageCode); // "fr"
console.log(props.regionCode); // "FR"
console.log(props.emoji); // "🇫🇷"

// Obtener propiedades de otros locales
const germanProps = gt.getLocaleProperties('de-AT');
console.log(germanProps.name); // "Austrian German"
console.log(germanProps.nativeName); // "Österreichisches Deutsch"
console.log(germanProps.regionName); // "Austria"
console.log(germanProps.nativeRegionName); // "Österreich"

Notas

  • Todos los name de visualización respetan la configuración sourceLocale de la instancia
  • Las propiedades de mapeo personalizadas tienen prioridad sobre las APIs estándar de Intl

Próximos pasos

¿Qué te parece esta guía?