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

    동적 사전

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

    기능 메타데이터 필드 useIntlayer의 셀렉터
    컬렉션 item: N { item: N }
    변형 variant: "name" 또는 variant: { … } { variant: "name" } 또는 { variant: { … } }

    둘 다 locale 인수와 결합되며 importMode를 통한 선택적 / 지연 로딩을 지원합니다.

    무엇을 언제 사용할지

    • 컬렉션 — 별도의 파일에서 관리되는 정렬된 항목 목록(FAQ 항목, 블로그 게시물, 제품).
    • 변형 — 이름이 지정되었거나 구조화된 콘텐츠 대안:
      • A/B 테스트, 시즌 배너 또는 기능 플래그를 위한 문자열 변형;
      • CMS 레코드, 사용자별 콘텐츠, 또는 필드 집합으로 주소가 지정되는 모든 콘텐츠를 위한 객체 변형(이전의 "동적 레코드").
    이전 버전은 레코드 키 기반 콘텐츠를 위해 별도의 meta 필드를 제공했습니다. 이는 variant로 통합되었습니다. meta를 사용하는 대신 variant에 객체를 전달하세요.

    셀렉터 모호성 해소

    키는 두 차원을 동시에 선언할 수 있습니다(예: 각 항목에 변형이 있는 컬렉션). 이는 다음 순서로 해결됩니다:

    plaintext
    variant → item

    따라서 variant × item 키에서 { variant: "promo" }는 모든 promo 항목을 배열로 반환하고, { item: 2 }를 추가하면 단일 항목으로 좁혀집니다.

    함수 가져오기
    컬렉션