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
| Parametro | Descrizione |
|---|---|
region | Codice di regione ISO 3166-1 alpha-2 o UN M.49. Se non specificato, utilizza la regione della locale di destinazione dell'istanza |
customMapping | Mappatura 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 inputname: Nome della regione localizzato nella lingua della locale di destinazioneemoji: 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.DisplayNamesper 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
- Recupera tutte le proprietà della locale con
getLocaleProperties - Recupera l’emoji della locale con
getLocaleEmoji
Come valuti questa guida?