getLocaleEmoji
Referencia de API del método getLocaleEmoji de GT
Descripción general
El método getLocaleEmoji obtiene una bandera o símbolo emoji para un código de configuración regional según su región.
Devuelve los emojis de bandera adecuados para países y territorios, con contenido de respaldo predeterminado para idiomas sin región específica y compatibilidad con emojis personalizados mediante asignaciones.
const gt = new GT({
sourceLocale: 'en',
targetLocale: 'fr-CA'
});
const emoji = gt.getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (bandera de Canadá)
const usEmoji = gt.getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (bandera de EE. UU.)
const enEmoji = gt.getLocaleEmoji('en');
console.log(enEmoji); // "🇺🇸" (bandera de EE. UU.)Referencias
Parámetros
Prop
Type
Descripción de parámetros
| Parámetro | Descripción |
|---|---|
locale | Código de configuración regional BCP-47 para obtener el emoji correspondiente. Si no se proporciona, usa el targetLocale de la instancia |
Devuelve
string - Emoji de bandera o símbolo que representa el locale:
- Emoji de bandera de país/territorio para locales con regiones (p. ej.,
🇺🇸,🇫🇷,🇯🇵) - Emoji específico del idioma para algunos idiomas sin región
- Emoji de bandera predeterminado (
🏳️) para locales no reconocidos
Lanza
Error- Si no se proporciona un locale y la instancia no tiene configurado untargetLocale
Ejemplos
const gt = new GT({
sourceLocale: 'en',
targetLocale: 'es'
});
// Obtener el emoji para el targetLocale
console.log(gt.getLocaleEmoji()); // "🇪🇸" (usa targetLocale 'es')
// Obtener emojis para distintos locales
console.log(gt.getLocaleEmoji('en-US')); // "🇺🇸"
console.log(gt.getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(gt.getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(gt.getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(gt.getLocaleEmoji('zh-CN')); // "🇨🇳"Notas
- Devuelve emojis de banderas según el código de región del locale cuando esté disponible
- Los emojis definidos de forma personalizada tienen prioridad sobre la selección basada en la región
- Utiliza símbolos de indicadores regionales de Unicode para generar las banderas
- Usa
🏳️(bandera blanca) por defecto para locales no reconocidos o no válidos - Compatible con todos los navegadores modernos y sistemas operativos que admiten emojis Unicode
Próximos pasos
- Obtén las propiedades de locale con
getLocaleProperties - Obtén los nombres de locale con
getLocaleName - Valida locales con
isValidLocale - Obtén más información sobre el tipo CustomMapping
¿Qué te parece esta guía?