Autor:
    Erstellung:2026-06-12Letzte Aktualisierung:2026-06-12

    Varianten

    Eine Variante (Variant) ist ein Satz von Inhaltsdateien, die denselben Wörterbuchschlüssel (key) teilen, aber jeweils einen anderen variant-Namen tragen. Intlayer liefert die entsprechende Datei basierend auf dem an useIntlayer übergebenen Selektor aus.

    Deklarieren von Varianten

    Jede Datei repräsentiert eine benannte Alternative. Wenn variant weggelassen wird (oder auf "default" gesetzt wird), gilt dies als Standardvariante (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;

    Nutzen von Varianten

    Standardvariante

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

    Benannte Variante

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

    Benannte Variante mit explizitem Locale

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

    Typische Anwendungsfälle

    • A/B-Kopiertests, die durch einen Experiment-Schlüssel gesteuert werden
    • Saisonale oder Werbe-Banner
    • Über Feature-Flags gesteuerte Nachrichten
    • Lokalspezifische Marketingkampagnen