getLocaleEmoji
Referencia de API de la función independiente getLocaleEmoji
Descripción general
La función independiente getLocaleEmoji obtiene una bandera o símbolo emoji para un código de configuración regional sin requerir una instancia de GT.
Devuelve emojis de bandera adecuados para países y territorios según la región del locale, con soporte para asignaciones personalizadas de emoji.
import { getLocaleEmoji } from 'generaltranslation';
const emoji = getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (bandera de Canadá)
const usEmoji = getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (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 el que obtener el emoji |
customMapping | Asignación personalizada opcional para códigos de configuración regional y anulación de emoji |
Devuelve
string - Emoji de bandera o símbolo que representa el locale:
- Emoji de bandera de país/territorio para locales con región (p. ej.,
🇺🇸,🇫🇷,🇯🇵) - Emoji personalizado si está definido en el mapeo
- Emoji de bandera predeterminado (
🏳️) para locales no reconocidos
Ejemplos
Recuperación básica de emojis
import { getLocaleEmoji } from 'generaltranslation';
// Banderas comunes de países
console.log(getLocaleEmoji('en-US')); // "🇺🇸"
console.log(getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(getLocaleEmoji('zh-CN')); // "🇨🇳"
// Regiones con múltiples idiomas
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"Notas
- Devuelve emojis de banderas usando los símbolos de indicadores regionales de Unicode
- Los emojis con asignaciones personalizadas tienen prioridad sobre la selección basada en la región
- Es compatible con todos los códigos de región ISO 3166-1 alfa-2 para una cobertura completa
Próximos pasos
- Usa el método de la GT class
getLocaleEmoji - Obtén las propiedades de un locale con
getLocaleProperties - Obtén los nombres de los locales con
getLocaleName - Valida los locales con
isValidLocale
¿Qué te parece esta guía?