Autore:
    Creazione:2026-06-12Ultimo aggiornamento:2026-06-12

    Varianti

    Una variante (Variant) è un insieme di file di contenuto che condividono la stessa chiave di dizionario (key) ma ognuno porta un nome di variante (variant) diverso. Intlayer serve il file appropriato in base al selettore passato a useIntlayer.

    Dichiarare le varianti

    Ogni file rappresenta un'alternativa denominata. Omettere variant (o impostarlo su "default") lo contrassegna come variante di fallback (predefinita).

    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;

    Consumare le varianti

    Variante predefinita

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

    Variante denominata

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

    Variante denominata con locale esplicita

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

    Casi d'uso tipici

    • Test A/B guidati da una chiave di esperimento
    • Banner stagionali o promozionali
    • Messaggi condizionati da feature flag
    • Campagne di marketing specifiche per area geografica