Panoramica

Il metodo getLocaleProperties recupera un set completo di proprietà per un codice locale, fornendo informazioni dettagliate tra cui nomi visualizzati, codici regione, informazioni sugli script e bandiere emoji. Restituisce un oggetto LocaleProperties completo con tutti i dati necessari per creare interfacce utente internazionalizzate ricche.

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

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

Riferimenti

Parametri

Descrizione dei parametri

Restituisce

LocaleProperties - Un oggetto completo che contiene tutte le informazioni sulla locale:

• code: Codice locale standardizzato
• name: Nome visualizzato nella locale di origine
• nativeName: Nome visualizzato nella locale stessa
• languageCode, languageName, nativeLanguageName: Informazioni sulla lingua
• regionCode, regionName, nativeRegionName: Informazioni sulla regione
• scriptCode, scriptName, nativeScriptName: Informazioni sul sistema di scrittura
• maximizedCode, minimizedCode: Forme canoniche
• nameWithRegionCode, nativeNameWithRegionCode: Formati di visualizzazione combinati
• emoji: Bandiera o emoji rappresentativo

Eccezioni generate

• Error - Se non viene fornita alcuna locale e l'istanza non ha una targetLocale configurata

Esempi

Utilizzo base

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

// Ottieni le proprietà della lingua/locale di destinazione
const props = gt.getLocaleProperties();
console.log(props.name); // "French (France)"
console.log(props.nativeName); // "français (France)"
console.log(props.languageCode); // "fr"
console.log(props.regionCode); // "FR"
console.log(props.emoji); // "🇫🇷"

// Ottieni le proprietà di altre lingue/locali
const germanProps = gt.getLocaleProperties('de-AT');
console.log(germanProps.name); // "Austrian German"
console.log(germanProps.nativeName); // "Österreichisches Deutsch"
console.log(germanProps.regionName); // "Austria"
console.log(germanProps.nativeRegionName); // "Österreich"

Note

• Tutti i nomi visualizzati rispettano l'impostazione sourceLocale dell'istanza
• Le proprietà di mapping personalizzato hanno la precedenza sulle API standard di Intl

Prossimi passi

• Esplora l’interfaccia LocaleProperties
• Ottieni nomi di locale semplificati con getLocaleName
• Ottieni l’emoji del locale con getLocaleEmoji
• Scopri il tipo CustomMapping