GT ClassMethodsLocales
determineLocale
API Reference für die GT-Methode determineLocale
Überblick
Die Methode determineLocale ermittelt anhand der Benutzerpräferenzen die bestmögliche locale aus einer Liste freigegebener locales.
Sie führt eine Locale‑Aushandlung durch, um die passendste locale zu finden, wenn keine exakten Übereinstimmungen verfügbar sind.
const gt = new GT({
sourceLocale: 'en-US',
locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});
// Exakte Übereinstimmung
console.log(gt.determineLocale('en-US')); // 'en-US'
// Sprach-Fallback
console.log(gt.determineLocale('en-GB')); // 'en-US' (nächste englische Variante)
// Mehrere Präferenzen
console.log(gt.determineLocale(['fr-CA', 'es-MX', 'en-US'])); // 'es-ES' (nächste spanische Variante)
// Keine Übereinstimmung
console.log(gt.determineLocale('it-IT')); // undefinedReferenzen
Parameter
Prop
Type
Rückgabewert
string | undefined – Bestpassende locale oder undefined, wenn keine Übereinstimmung gefunden wurde
Beispiele
Aushandlung der Benutzer-Locale
const gt = new GT({
sourceLocale: 'en-US',
locales: ['en-US', 'en-GB', 'es-ES', 'fr-FR']
});
// Browser Accept-Language Header simulieren
const userPreferences = ['fr-CA', 'en-GB', 'en'];
const bestMatch = gt.determineLocale(userPreferences);
console.log(bestMatch); // 'fr-FR' basierend auf PräferenzreihenfolgeHinweise
- Gibt die erste exakte Übereinstimmung aus den freigegebenen locales zurück
- Fällt auf Sprachübereinstimmungen zurück, wenn die genaue Region nicht verfügbar ist
- Respektiert die Präferenzreihenfolge im Eingabe-Array
- Gibt undefined zurück, wenn keine passende Übereinstimmung gefunden wird
- Wesentlich für die Implementierung von locale‑Aushandlung in Webanwendungen
Nächste Schritte
- Prüfen Sie den Übersetzungsbedarf mit
requires-translation - Vergleichen Sie Sprachen mit
is-same-language
Wie ist dieser Leitfaden?