getRegionProperties
API-Referenz für die GT-Methode getRegionProperties
Überblick
Die Methode getRegionProperties ruft detaillierte Informationen zu einem Regionscode ab, darunter den lokalisierten Namen und die zugehörige Länderflagge (Emoji).
Sie bietet eine praktische Möglichkeit, regionsspezifische Anzeigeinformationen für den Aufbau internationalisierter Benutzeroberflächen zu beziehen.
const gt = new GT({
  sourceLocale: 'en-US',
  targetLocale: 'fr-FR'
});
// Regionseigenschaften abrufen
const usProps = gt.getRegionProperties('US');
console.log(usProps);
// { code: 'US', name: 'Vereinigte Staaten', emoji: '🇺🇸' }
const frProps = gt.getRegionProperties('FR');
console.log(frProps);
// { code: 'FR', name: 'Frankreich', emoji: '🇫🇷' }
// Automatische Erkennung aus aktueller Locale
const currentRegion = gt.getRegionProperties(); // Verwendet die Region der targetLocale
console.log(currentRegion);
// { code: 'FR', name: 'Frankreich', emoji: '🇫🇷' }Referenz
Parameter
Prop
Type
Parameterbeschreibung
| Parameter | Beschreibung | 
|---|---|
| region | ISO-3166-1-Alpha-2- oder UN-M.49-Regionscode. Wenn nicht angegeben, wird die Region aus der Ziel-locale der Instanz verwendet | 
| customMapping | Optionale benutzerdefinierte Regionszuordnung, um Standard-Regionsnamen und -Emojis zu überschreiben | 
Rückgabe
{ code: string; name: string; emoji: string } - Objekt mit:
- code: Der eingegebene Regionscode
- name: Lokalisierter Regionsname in der Zielsprache der locale
- emoji: Zugeordnete Emoji-Flagge oder -Symbol
Beispiele
Grundlegende Informationen zur Region
const gt = new GT({
  sourceLocale: 'en-US',
  targetLocale: 'en-US'
});
// Häufige Regionscodes
console.log(gt.getRegionProperties('US')); // { code: 'US', name: 'Vereinigte Staaten', emoji: '🇺🇸' }
console.log(gt.getRegionProperties('GB')); // { code: 'GB', name: 'Vereinigtes Königreich', emoji: '🇬🇧' }
console.log(gt.getRegionProperties('DE')); // { code: 'DE', name: 'Deutschland', emoji: '🇩🇪' }
console.log(gt.getRegionProperties('JP')); // { code: 'JP', name: 'Japan', emoji: '🇯🇵' }Hinweise
- Verwendet die Intl.DisplayNames-API für lokalisierte Regionsnamen
- Unterstützt sowohl ISO 3166-1 alpha-2 als auch UN M.49-Regionscodes
- Benutzerdefinierte Zuordnungen überschreiben Standardnamen und Emojis
- Erkennt die Region automatisch anhand der Ziel-Locale, wenn kein Parameter angegeben ist
- Fällt auf den Regionscode als Namen zurück, wenn die Auflösung des Anzeigenamens fehlschlägt
Nächste Schritte
- Vollständige Locale-Eigenschaften mit getLocalePropertiesabrufen
- Das Locale-Emoji mit getLocaleEmojiabrufen
Wie ist dieser Leitfaden?

