GT ClassMethodsLocales

getRegionProperties

Reference API per il metodo GT getRegionProperties

Panoramica

Il metodo getRegionProperties recupera informazioni dettagliate su un codice di regione, tra cui il nome localizzato e l’emoji della relativa bandiera. Offre un modo pratico per ottenere informazioni di presentazione specifiche della regione utili a creare interfacce utente internazionalizzate.

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

// Ottieni le proprietà della regione
const usProps = gt.getRegionProperties('US');
console.log(usProps);
// { code: 'US', name: 'United States', emoji: '🇺🇸' }

const frProps = gt.getRegionProperties('FR');
console.log(frProps);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }

// Rilevamento automatico dalla locale corrente
const currentRegion = gt.getRegionProperties(); // Usa la regione del targetLocale
console.log(currentRegion);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }

Riferimenti

Parametri

Prop

Type

Descrizione dei parametri

ParametroDescrizione
regionCodice di regione ISO 3166-1 alpha-2 o UN M.49. Se non specificato, utilizza la regione della locale di destinazione dell'istanza
customMappingMappatura personalizzata delle regioni (facoltativa) per sostituire i nomi delle regioni e le emoji predefiniti

Restituisce

{ code: string; name: string; emoji: string } - Oggetto contenente:

  • code: Il codice della regione in input
  • name: Nome della regione localizzato nella lingua della locale di destinazione
  • emoji: Bandiera emoji o simbolo associato

Esempi

Informazioni di base sulla regione

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

// Codici regione comuni
console.log(gt.getRegionProperties('US')); // { code: 'US', name: 'Stati Uniti', emoji: '🇺🇸' }
console.log(gt.getRegionProperties('GB')); // { code: 'GB', name: 'Regno Unito', emoji: '🇬🇧' }
console.log(gt.getRegionProperties('DE')); // { code: 'DE', name: 'Germania', emoji: '🇩🇪' }
console.log(gt.getRegionProperties('JP')); // { code: 'JP', name: 'Giappone', emoji: '🇯🇵' }

Note

  • Utilizza l’API Intl.DisplayNames per i nomi di regione localizzati
  • Supporta sia i codici di regione ISO 3166-1 alpha-2 sia quelli UN M.49
  • Le mappature personalizzate sovrascrivono i nomi e le emoji predefiniti
  • Rileva automaticamente la regione dalla locale di destinazione se non viene fornito alcun parametro
  • Se la risoluzione del nome visualizzato non riesce, usa il codice della regione come nome

Prossimi passaggi

Come valuti questa guida?

getRegionProperties