GT ClassMethodsLocales

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

ParameterBeschreibung
regionISO-3166-1-Alpha-2- oder UN-M.49-Regionscode. Wenn nicht angegeben, wird die Region aus der Ziel-locale der Instanz verwendet
customMappingOptionale 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

Wie ist dieser Leitfaden?

getRegionProperties