Panoramica

Il metodo getLocaleName recupera il nome visualizzato di un codice di localizzazione utilizzando l’API Intl.DisplayNames. Restituisce un nome leggibile per qualsiasi codice di localizzazione BCP‑47 valido, localizzato in base alla lingua di origine dell’istanza.

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

const name = gt.getLocaleName('fr-CA');
console.log(name); // "francese (Canada)"

Riferimenti

Parametri

Descrizione dei parametri

Restituisce

string - Il nome localizzato visualizzato della locale.

Eccezioni generate

• Error - Se non viene specificato un locale e l'istanza non ha un targetLocale configurato

Comportamento

Lingua di visualizzazione

Il nome visualizzato è localizzato in base a:

1. sourceLocale dell’istanza (se configurato)
2. Locale predefinito della libreria (“en”)

Integrazione con mappature personalizzate

• Le mappature di locale personalizzate vengono verificate per prime
• Se è definito un nome personalizzato, ha la precedenza
• In assenza, si ricorre a Intl.DisplayNames per i codici BCP‑47 standard

Esempi

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

// Ottieni il nome della lingua di destinazione
console.log(gt.getLocaleName()); // "Francese (Francia)"

// Ottieni i nomi delle altre lingue
console.log(gt.getLocaleName('es')); // "Spagnolo (Spagna)"
console.log(gt.getLocaleName('de')); // "Tedesco (Germania)"
console.log(gt.getLocaleName('ja')); // "Giapponese (Giappone)"

Note

• Il metodo utilizza il sourceLocale dell'istanza per determinare la lingua di visualizzazione
• I nomi di mapping personalizzati hanno la precedenza su Intl.DisplayNames standard

Prossimi passaggi

• Ottieni l’emoji della locale con getLocaleEmoji
• Ottieni informazioni complete sulla locale con getLocaleProperties
• Scopri il tipo CustomMapping