Autor:
    Creación:2026-06-12Última actualización:2026-06-12

    Variantes

    Una variante es un conjunto de archivos de contenido que comparten la misma clave de diccionario (key) pero cada uno lleva un nombre de variante (variant) diferente. Intlayer sirve el archivo apropiado en función del selector pasado a useIntlayer.

    Declarar variantes

    Cada archivo representa una alternativa nombrada. Omitir variant (o establecerlo en "default") lo marca como la variante por defecto (fallback).

    hero-banner.content.ts
    import { t, type Dictionary } from "intlayer";
    
    const dictionary = {
      key: "hero-banner",
      variant: "default",
      content: {
        headline: t({
          en: "Build faster with Intlayer",
          fr: "Développez plus vite avec Intlayer",
        }),
        cta: t({ en: "Get started", fr: "Commencer" }),
      },
    } satisfies Dictionary;
    
    export default dictionary;
    hero-banner.black-friday.content.ts
    import { t, type Dictionary } from "intlayer";
    
    const dictionary = {
      key: "hero-banner",
      variant: "black_friday",
      content: {
        headline: t({
          en: "50 % off — today only",
          fr: "−50 % — aujourd'hui seulement",
        }),
        cta: t({ en: "Shop now", fr: "Acheter maintenant" }),
      },
    } satisfies Dictionary;
    
    export default dictionary;

    Consumir variantes

    Variante por defecto

    Hero.tsx
    import { useIntlayer } from "react-intlayer";
    
    export const Hero = () => {
      const { headline, cta } = useIntlayer("hero-banner");
      // → variante por defecto
    
      return (
        <section>
          <h1>{headline}</h1>
          <a>{cta}</a>
        </section>
      );
    };

    Variante nombrada

    tsx
    const { headline, cta } = useIntlayer("hero-banner", {  variant: "black_friday",});

    Variante nombrada con configuración regional explícita

    tsx
    const content = useIntlayer("hero-banner", {  variant: "black_friday",  locale: "es",});

    Casos de uso típicos

    • Pruebas A/B impulsadas por una clave de experimento
    • Banners promocionales o estacionales
    • Mensajes bajo indicadores de función (feature flags)
    • Campañas de marketing específicas para una región