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ámetro | Descripción |
|---|---|
locale | Có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 estandarizadoname: Nombre para mostrar en la configuración regional de origennativeName: Nombre para mostrar en la propia configuración regionallanguageCode,languageName,nativeLanguageName: Información del idiomaregionCode,regionName,nativeRegionName: Información de la regiónscriptCode,scriptName,nativeScriptName: Información del sistema de escrituramaximizedCode,minimizedCode: Formas canónicasnameWithRegionCode,nativeNameWithRegionCode: Formatos de visualización combinadosemoji: Bandera o emoji representativo
Genera
Error- Si no se proporciona un locale y la instancia no tienetargetLocaleconfigurado
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
namede visualización respetan la configuraciónsourceLocalede la instancia - Las propiedades de mapeo personalizadas tienen prioridad sobre las APIs estándar de Intl
Próximos pasos
- Explora la interfaz
LocaleProperties - Obtén nombres de locale simplificados con
getLocaleName - Obtén el emoji del locale con
getLocaleEmoji - Aprende sobre el tipo
CustomMapping
¿Qué te parece esta guía?