GT ClassMethodsLocales
getRegionProperties
Référence de l’API pour la méthode getRegionProperties de GT
Vue d’ensemble
La méthode getRegionProperties renvoie des informations détaillées sur un code de région, notamment son nom localisé et l’emoji de drapeau associé.
Elle offre un moyen pratique d’obtenir des informations d’affichage propres à une région pour créer des interfaces utilisateur internationalisées.
const gt = new GT({
sourceLocale: 'en-US',
targetLocale: 'fr-FR'
});
// Récupérer les propriétés de région
const usProps = gt.getRegionProperties('US');
console.log(usProps);
// { code: 'US', name: 'États-Unis', emoji: '🇺🇸' }
const frProps = gt.getRegionProperties('FR');
console.log(frProps);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }
// Détection automatique depuis la locale actuelle
const currentRegion = gt.getRegionProperties(); // Utilise la région de localeCible
console.log(currentRegion);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }Références
Paramètres
Prop
Type
Description des paramètres
| Paramètre | Description |
|---|---|
region | Code de région ISO 3166-1 alpha-2 ou UN M.49. S’il n’est pas fourni, la région du locale cible de l’instance est utilisée |
customMapping | Mappage de région personnalisé facultatif pour remplacer les noms de régions et les emoji par défaut |
Renvoie
{ code: string; name: string; emoji: string } - Objet contenant :
code: Code de région en entréename: Nom de la région localisé dans la langue de la locale cibleemoji: Drapeau ou symbole emoji associé
Exemples
Informations de base sur la région
const gt = new GT({
sourceLocale: 'en-US',
targetLocale: 'en-US'
});
// Codes de région courants
console.log(gt.getRegionProperties('US')); // { code: 'US', name: 'États-Unis', emoji: '🇺🇸' }
console.log(gt.getRegionProperties('GB')); // { code: 'GB', name: 'Royaume-Uni', emoji: '🇬🇧' }
console.log(gt.getRegionProperties('DE')); // { code: 'DE', name: 'Allemagne', emoji: '🇩🇪' }
console.log(gt.getRegionProperties('JP')); // { code: 'JP', name: 'Japon', emoji: '🇯🇵' }Notes
- Utilise l’API
Intl.DisplayNamespour les noms de régions localisés - Prend en charge les codes de région ISO 3166‑1 alpha‑2 et ONU M.49
- Les correspondances personnalisées remplacent les noms et les emoji par défaut
- Détecte automatiquement la région à partir du locale cible si aucun paramètre n’est fourni
- Utilise le code de région comme nom si la résolution du nom d’affichage échoue
Prochaines étapes
- Récupérez toutes les propriétés de la locale avec
getLocaleProperties - Récupérez l’emoji de la locale avec
getLocaleEmoji
Comment trouvez-vous ce guide ?