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 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ámetroDescripción
localeCódigo de configuración regional BCP-47 para el que obtener el emoji
customMappingAsignació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

¿Qué te parece esta guía?