Überblick

Die eigenständige Funktion getLocaleName ermittelt den Anzeigenamen eines locale code, ohne eine Instanz der GT‑Klasse zu benötigen. Sie verwendet die API Intl.DisplayNames, um lokalisierte locale names für jeden gültigen BCP‑47 locale code bereitzustellen.

import { getLocaleName } from 'generaltranslation';

const name = getLocaleName('fr-CA', 'en');
console.log(name); // "Französisch (Kanada)"

Referenzen

Parameter

Parameterbeschreibung

Rückgabewert

string – Der lokalisierte Anzeigename der locale.

Verhalten

Auflösung der Anzeigesprache

Die Funktion lokalisiert Namen in folgender Reihenfolge:

1. defaultLocale-Parameter (falls angegeben)
2. Standard-Locale der Bibliothek („en“)

Integration benutzerdefinierter Zuordnungen

• Benutzerdefinierte Zuordnungen werden zuerst geprüft, sowohl für locale code als auch für name
• Unterstützt die Auflösung von Aliasen und benutzerdefinierte Anzeigenamen
• Fällt für nicht zugeordnete Codes auf das standardmäßige Intl.DisplayNames zurück

Strategie zur Namensauflösung

1. Benutzerdefinierte Zuordnung (höchste Priorität)
2. Intl.DisplayNames in der Standardlocale
3. Intl.DisplayNames in der Bibliotheks-Standardsprache („en“)
4. Locale-Code selbst (Standardwert)

Beispiele

import { getLocaleName } from 'generaltranslation';

// Englische Anzeigenamen
console.log(getLocaleName('es', 'en')); // „Spanisch (Spanien)“
console.log(getLocaleName('ja', 'en')); // „Japanisch (Japan)“
console.log(getLocaleName('zh', 'en')); // „Chinesisch (China)“

Locale options erstellen

import { getLocaleName, getLocaleEmoji } from 'generaltranslation';

function buildLocaleOptions(
  supportedLocales: string[],
  displayLocale: string = 'en'
) {
  return supportedLocales.map(locale => ({
    value: locale,
    label: getLocaleName(locale, displayLocale),
    emoji: getLocaleEmoji(locale)
  }));
}

const options = buildLocaleOptions([
  'en',
  'es',
  'fr',
  'de',
  'ja'
], 'en');

console.log(options);
// [
//   { value: 'en', label: 'Englisch (Vereinigte Staaten)', emoji: '🇺🇸' },
//   { value: 'es', label: 'Spanisch (Spanien)', emoji: '🇪🇸' },
//   ...
// ]

Hinweise

• Benutzerdefinierte Zuordnungen haben Vorrang vor Intl.DisplayNames
• Gibt den locale code selbst zurück, wenn kein Anzeigename ermittelt werden kann
• Der Anzeige-locale-Parameter bestimmt die Sprache des zurückgegebenen name

Nächste Schritte

• Hole dir das Locale-Emoji mit getLocaleEmoji
• Nutze die GT-Klasse für zustandsbehaftete Operationen: getLocaleName
• Erfahre mehr über den Typ CustomMapping