Überblick

Die Methode getLocaleProperties ruft umfassende Eigenschaften für einen Locale-Code ab und liefert detaillierte Informationen, einschließlich Anzeigenamen, Regionscodes, Skriptinformationen und Emoji-Flags. Sie gibt ein vollständiges LocaleProperties-Objekt mit allen erforderlichen Daten für die Entwicklung umfangreicher, internationalisierter Benutzeroberflächen zurück.

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

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

Referenzen

Parameter

Parameterbeschreibung

Rückgabe

LocaleProperties - Ein umfassendes Objekt mit allen Informationen zur Locale:

• code: Standardisierter Locale-Code
• name: Anzeigename in der Quell-Locale
• nativeName: Anzeigename in der Locale selbst
• languageCode, languageName, nativeLanguageName: Sprachinformationen
• regionCode, regionName, nativeRegionName: Regionsinformationen
• scriptCode, scriptName, nativeScriptName: Schriftinformationen
• maximizedCode, minimizedCode: Kanonische Formen
• nameWithRegionCode, nativeNameWithRegionCode: Kombinierte Anzeigeformate
• emoji: Flagge oder repräsentatives Emoji

Wirft

• Error – Wenn keine locale angegeben ist und die Instanz keine targetLocale konfiguriert hat

Beispiele

Grundlegende Verwendung

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

// Eigenschaften für das targetLocale abrufen
const props = gt.getLocaleProperties();
console.log(props.name); // "Französisch (Frankreich)"
console.log(props.nativeName); // "français (France)"
console.log(props.languageCode); // "fr"
console.log(props.regionCode); // "FR"
console.log(props.emoji); // "🇫🇷"

// Eigenschaften für andere locales abrufen
const germanProps = gt.getLocaleProperties('de-AT');
console.log(germanProps.name); // "Österreichisches Deutsch"
console.log(germanProps.nativeName); // "Österreichisches Deutsch"
console.log(germanProps.regionName); // "Österreich"
console.log(germanProps.nativeRegionName); // "Österreich"

Hinweise

• Alle Anzeigenamen richten sich nach der sourceLocale-Einstellung der Instanz
• Benutzerdefinierte Mapping-Eigenschaften haben Vorrang vor den standardmäßigen Intl APIs

Nächste Schritte

• Entdecke das Interface LocaleProperties
• Hole dir einfache locale‑Namen mit getLocaleName
• Hole dir locale‑Emoji mit getLocaleEmoji
• Erfahre mehr über den Typ CustomMapping