Vue d’ensemble

La méthode getLocaleProperties récupère l’ensemble des propriétés d’un code de locale, fournissant des informations détaillées, notamment les noms d’affichage, les codes régionaux, les informations d’écriture et les drapeaux emoji. Elle renvoie un objet LocaleProperties complet contenant toutes les données nécessaires pour créer des interfaces utilisateur riches et internationalisées.

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

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

Référence

Paramètres

Description des paramètres

Renvoie

LocaleProperties - Un objet complet contenant toutes les informations de locale :

• code: Code de locale normalisé
• name: Nom d’affichage dans la langue source
• nativeName: Nom d’affichage dans la locale elle‑même
• languageCode, languageName, nativeLanguageName: Informations sur la langue
• regionCode, regionName, nativeRegionName: Informations sur la région
• scriptCode, scriptName, nativeScriptName: Informations sur l’écriture
• maximizedCode, minimizedCode: Formes canoniques
• nameWithRegionCode, nativeNameWithRegionCode: Formats d’affichage combinés
• emoji: Drapeau ou emoji représentatif

Lève

• Error - Si aucune locale n’est fournie et que l’instance n’a pas de targetLocale configuré

Exemples

Utilisation de base

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

// Obtenir les propriétés de la locale cible
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); // "🇫🇷"

// Obtenir les propriétés d'autres 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"

Notes

• Tous les noms d’affichage respectent le paramètre sourceLocale de l’instance
• Les propriétés de mappage personnalisées ont priorité sur les API Intl standard

Prochaines étapes

• Découvrir l’interface LocaleProperties
• Récupérer des noms de locale simplifiés avec getLocaleName
• Récupérer l’emoji de la locale avec getLocaleEmoji
• En savoir plus sur le type CustomMapping