Documentación: Función getTranslationContent en intlayer

Descripción

La función getTranslationContent recupera el contenido correspondiente a una localidad específica de un conjunto de contenido de idioma personalizable. Si no se encuentra la localidad especificada, devuelve por defecto el contenido de la localidad predeterminada configurada en el proyecto.

Parámetros

• languageContent: CustomizableLanguageContent<Content>

  • Descripción: Un objeto que contiene traducciones para varias localidades. Cada clave representa una localidad y su valor es el contenido correspondiente.
  • Tipo: CustomizableLanguageContent<Content>
    • Content puede ser de cualquier tipo, por defecto string.

• locale: Locales

  • Descripción: La localidad para la cual se desea obtener el contenido.
  • Tipo: Locales

Retorna

• Tipo: Content
• Descripción: El contenido correspondiente a la localidad especificada. Si no se encuentra la localidad, se devuelve el contenido de la localidad predeterminada.

Ejemplo de uso

Uso básico

import { getTranslationContent, Locales } from "intlayer";

const content = getTranslationContent(
  {
    en: "Hello",
    fr: "Bonjour",
  },
  Locales.ENGLISH
);

console.log(content); // Salida: "Bonjour"

Localidad faltante:

import { getTranslationContent, Locales } from "intlayer";

const content = getTranslationContent(
  {
    en: "Hello",
    fr: "Bonjour",
  },
  Locales.SPANISH
);

console.log(content); // Salida: "Hello" (contenido de la localidad predeterminada)

Uso de Tipos de Contenido Personalizados:

import { getTranslationContent, Locales } from "intlayer";

const customContent = getTranslationContent<Record<string, string>>(
  {
    en: { greeting: "Hello" },
    fr: { greeting: "Bonjour" },
  },
  Locales.FRENCH
);

console.log(customContent.greeting); // Salida: "Bonjour"

Casos Especiales

• Localidad No Encontrada:
  • Cuando la locale no se encuentra en el languageContent, la función devuelve el contenido para la localidad predeterminada.
• Contenido de Idioma Incompleto:
  • Si una localidad está parcialmente definida, la función no fusiona los contenidos. Recupera estrictamente el valor de la localidad especificada o recurre a la predeterminada.
• Aplicación de TypeScript:
  • Si las localidades en languageContent no coinciden con la configuración del proyecto, TypeScript exigirá que todas las localidades requeridas estén definidas, asegurando que el contenido sea completo y seguro en cuanto a tipos.