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

    동적 사전

    Intlayer는 키당 하나의 정적 사전을 정의하는 것을 넘어선 콘텐츠를 표현하기 위한 세 가지 메커니즘을 지원합니다. 각각은 콘텐츠 파일 내의 최상위 메타데이터 필드를 통해 선언되며, 래퍼 함수는 필요하지 않습니다.

    기능 메타데이터 필드 useIntlayer에서의 선택기
    컬렉션 item: N { item: N }
    변형 variant: "name" { variant: "name" }
    동적 레코드 meta: { id, … } { id, … }

    세 메커니즘 모두 로케일 인수와 결합하며, importMode를 통한 선택적 / 지연 로딩을 지원합니다.

    언제 무엇을 사용해야 하는가

    • 컬렉션 — 별도의 파일로 관리되는 정렬된 항목 목록(FAQ 항목, 블로그 게시물, 상품 등).
    • 변형 — A/B 테스트, 시즌별 배너 또는 기능 플래그(feature flags)를 위한 이름이 지정된 대체 콘텐츠.
    • 동적 레코드 — 불투명한 ID를 사용하여 런타임에 검색되는 콘텐츠(CMS 레코드, 사용자별 텍스트 등).

    선택기 우선순위 해결

    하나의 사전에 여러 선택기가 있는 경우 해결 순서는 다음과 같습니다:

    plaintext
    variant → meta → item