Yazar:
    Oluşturma:2026-06-12Son güncelleme:2026-06-12

    Varyantlar

    Bir varyant (variant), aynı sözlük anahtarını (key) paylaşan ancak her biri farklı bir variant adı taşıyan içerik dosyaları kümesidir. Intlayer, useIntlayer fonksiyonuna geçirilen seçiciye göre uygun dosyayı sunar.

    Varyantları bildirme

    Her dosya adlandırılmış bir alternatifi temsil eder. variant alanının atlanması (veya "default" olarak ayarlanması) onu varsayılan (fallback) varyant olarak işaretler.

    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;

    Varyantları tüketme

    Varsayılan varyant

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

    Adlandırılmış varyant

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

    Belirli dil seçeneği ile adlandırılmış varyant

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

    Tipik kullanım senaryoları

    • Bir deney anahtarı (experiment key) tarafından yönlendirilen A/B metin testleri
    • Dönemsel veya tanıtım afişleri
    • Özellik bayraklı (feature flag) mesajlaşma
    • Bölgeye özel pazarlama kampanyaları