Utility FunctionsLocales

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 la clase GT. Devuelve emojis de bandera adecuados para países y territorios según la región del locale, y admite 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ámetroDescripción
localecódigo de configuración regional BCP-47 para obtener el emoji correspondiente
customMappingasignación personalizada opcional para códigos de configuración regional y para reemplazar emojis

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

Obtención básica de emoji

import { getLocaleEmoji } from 'generaltranslation';

// Banderas de países comunes
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 varios 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 bandera mediante símbolos de indicador regional de Unicode
  • Los emojis definidos por 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

¿Qué te ha parecido esta guía?

getLocaleEmoji