작가:

생성:2026-06-12마지막 업데이트:2026-06-12

이 문서를 원하는 AI 어시스턴트에 참조하세요ChatGPT Claude DeepSeek Google AI mode Gemini Perplexity Mistral Grok

이 페이지와 원하는 AI 어시스턴트를 사용하여 문서를 요약합니다

버전 기록

"변형 사전 기능 출시"
v9.0.02026. 6. 12.

이 페이지의 콘텐츠는 AI를 사용하여 번역되었습니다.

영어 원본 내용의 최신 버전을 보기

문서 수정

이 문서를 개선할 아이디어가 있으시면 GitHub에 풀 리퀘스트를 제출하여 자유롭게 기여해 주세요.

문서에 대한 GitHub 링크

복사

문서의 Markdown을 클립보드에 복사

변형

Name: Intlayer
Author: Intlayer

변형(Variant)은 동일한 사전 키(key)를 공유하지만 서로 다른 variant 이름을 선언하는 콘텐츠 파일의 집합입니다. Intlayer는 useIntlayer에 전달된 선택기에 따라 적절한 파일을 서비스합니다.

변형 선언

각 파일은 하나의 이름이 지정된 대체 콘텐츠를 나타냅니다. variant 필드를 생략하거나 "default"로 설정하면 기본(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;

변형 소비하기

기본 변형

Hero.tsx

코드 복사

코드를 클립보드에 복사

import { useIntlayer } from "react-intlayer";

export const Hero = () => {
  const { headline, cta } = useIntlayer("hero-banner");
  // → 기본 변형

  return (
    <section>
      <h1>{headline}</h1>
      <a>{cta}</a>
    </section>
  );
};

Hero.tsx

코드 복사

코드를 클립보드에 복사

import { useIntlayer } from "next-intlayer";

export const Hero = () => {
  const { headline, cta } = useIntlayer("hero-banner");
  // → 기본 변형

  return (
    <section>
      <h1>{headline}</h1>
      <a>{cta}</a>
    </section>
  );
};

Hero.vue

코드 복사

코드를 클립보드에 복사

<script setup>
import { useIntlayer } from "vue-intlayer";
const { headline, cta } = useIntlayer("hero-banner");
</script>

<template>
  <section>
    <h1>{{ headline }}</h1>
    <a>{{ cta }}</a>
  </section>
</template>

Hero.svelte

코드 복사

코드를 클립보드에 복사

<script lang="ts">
import { useIntlayer } from "svelte-intlayer";
const content = useIntlayer("hero-banner");
</script>

<section>
  <h1>{$content.headline}</h1>
  <a>{$content.cta}</a>
</section>

Hero.tsx

코드 복사

코드를 클립보드에 복사

import { useIntlayer } from "preact-intlayer";

export const Hero = () => {
  const { headline, cta } = useIntlayer("hero-banner");
  // → 기본 변형

  return (
    <section>
      <h1>{headline}</h1>
      <a>{cta}</a>
    </section>
  );
};

Hero.tsx

코드 복사

코드를 클립보드에 복사

import { useIntlayer } from "solid-intlayer";

export const Hero = () => {
  const content = useIntlayer("hero-banner");
  // → 기본 변형

  return (
    <section>
      <h1>{content().headline}</h1>
      <a>{content().cta}</a>
    </section>
  );
};

hero.component.ts

코드 복사

코드를 클립보드에 복사

import { Component } from "@angular/core";
import { useIntlayer } from "angular-intlayer";

@Component({
  selector: "app-hero",
  template: `
    <section>
      <h1>{{ content().headline }}</h1>
      <a>{{ content().cta }}</a>
    </section>
  `,
})
export class HeroComponent {
  content = useIntlayer("hero-banner");
}

hero.js

코드 복사

코드를 클립보드에 복사

import { useIntlayer } from "vanilla-intlayer";const { headline, cta } = useIntlayer("hero-banner");document.body.innerHTML = `  <section>    <h1>${headline}</h1>    <a>${cta}</a>  </section>`;

이름이 지정된 변형

tsx

코드 복사

코드를 클립보드에 복사

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

명시적 로케일로 이름이 지정된 변형

tsx

코드 복사

코드를 클립보드에 복사

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

일반적인 사용 사례

실험 키(experiment key)에 따른 A/B 카피 테스트
시즌별 또는 프로모션 배너
기능 플래그(feature flags)로 제어되는 문구
특정 로케일 타겟 마케팅 캠페인

컬렉션 동적 레코드