GT ClassMethodsLocales
getRegionProperties
Référence de l’API de la méthode GT getRegionProperties
Aperçu
La méthode getRegionProperties récupère 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'
});
// Obtenir 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 à partir de la locale actuelle
const currentRegion = gt.getRegionProperties(); // Utilise la région de targetLocale
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 renseigné, la région du locale cible de l'instance sera utilisée |
customMapping | Mappage personnalisé des régions (facultatif) pour remplacer les noms de région et les emoji par défaut |
Renvoie
{ code: string; name: string; emoji: string } - Objet contenant :
code: Le code de région fourni en entréename: Nom de région localisé dans la langue de la locale cibleemoji: Emoji de drapeau ou symbole associé
Exemples
Informations de base sur la région
const gt = new GT({
sourceLocale: 'en-US',
localeCible: '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égion 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
- Se rabat sur 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
Que pensez-vous de ce guide ?