GT ClassMethodsLocales
determineLocale
Riferimento API per il metodo GT determineLocale
Panoramica
Il metodo determineLocale individua la locale più adatta da un elenco di locale approvate in base alle preferenze dell’utente.
Implementa la negoziazione della locale per trovare la soluzione più appropriata quando non sono disponibili corrispondenze esatte.
const gt = new GT({
sourceLocale: 'en-US',
locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});
// Corrispondenza esatta
console.log(gt.determineLocale('en-US')); // 'en-US'
// Fallback linguistico
console.log(gt.determineLocale('en-GB')); // 'en-US' (variante inglese più simile)
// Preferenze multiple
console.log(gt.determineLocale(['fr-CA', 'es-MX', 'en-US'])); // 'es-ES' (spagnolo più simile)
// Nessuna corrispondenza
console.log(gt.determineLocale('it-IT')); // undefinedRiferimenti
Parametri
Prop
Type
Restituisce
string | undefined - Locale migliore corrispondente oppure undefined se non viene trovata alcuna corrispondenza
Esempi
Negoziazione della lingua dell’utente
const gt = new GT({
sourceLocale: 'en-US',
locales: ['en-US', 'en-GB', 'es-ES', 'fr-FR']
});
// Simula l'intestazione Accept-Language del browser
const userPreferences = ['fr-CA', 'en-GB', 'en'];
const bestMatch = gt.determineLocale(userPreferences);
console.log(bestMatch); // 'fr-FR' in base all'ordine di preferenzaNote
- Restituisce la prima corrispondenza esatta dalle locale approvate
- Esegue il fallback su corrispondenze di lingua quando la regione esatta non è disponibile
- Rispetta l’ordine di preferenza nell’array di input
- Restituisce undefined quando non viene trovata alcuna corrispondenza adatta
- Essenziale per implementare la negoziazione delle locale nelle applicazioni web
Prossimi passaggi
- Verifica le necessità di traduzione con
requires-translation - Confronta le lingue con
is-same-language
Come valuti questa guida?