생성:2026-06-12마지막 업데이트:2026-06-12
이 문서를 원하는 AI 어시스턴트에 참조하세요ChatGPTClaudeDeepSeekGoogle AI modeGeminiPerplexityMistralGrok
이 페이지와 원하는 AI 어시스턴트를 사용하여 문서를 요약합니다
버전 기록
- "컬렉션 사전 기능 출시"v9.0.02026. 6. 12.
이 페이지의 콘텐츠는 AI를 사용하여 번역되었습니다.
영어 원본 내용의 최신 버전을 보기Edit this doc
If you have an idea for improving this documentation, please feel free to contribute by submitting a pull request on GitHub.
GitHub link to the documentationCopy
Copy doc Markdown to clipboard
컬렉션
컬렉션(Collection)은 동일한 사전 키(key)를 공유하지만 서로 다른 item 인덱스를 선언하는 콘텐츠 파일의 집합입니다. Intlayer는 빌드 시 이를 하나의 정렬된 목록으로 병합합니다.
컬렉션 항목 선언
각 파일은 하나의 항목을 나타냅니다. item 필드는 목록에서의 해당 위치입니다(1부터 시작).
faq.1.content.ts
코드 복사
코드를 클립보드에 복사
import { t, type Dictionary } from "intlayer";
const dictionary = {
key: "faq",
item: 1,
content: {
question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
},
} satisfies Dictionary;
export default dictionary;faq.2.content.ts
코드 복사
코드를 클립보드에 복사
import { t, type Dictionary } from "intlayer";
const dictionary = {
key: "faq",
item: 2,
content: {
question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
},
} satisfies Dictionary;
export default dictionary;컬렉션 소비하기
모든 항목
FAQ.tsx
코드 복사
코드를 클립보드에 복사
import { useIntlayer } from "react-intlayer";export const FAQ = () => { const items = useIntlayer("faq"); // { question: string; answer: string }[] return ( <ul> {items.map((item, index) => ( <li key={index}> <strong>{item.question}</strong> <p>{item.answer}</p> </li> ))} </ul> );};인덱스로 단일 항목 가져오기
tsx
코드 복사
코드를 클립보드에 복사
const faq2 = useIntlayer("faq", { item: 2 });// → { question: string; answer: string }명시적 로케일로 단일 항목 가져오기
tsx
코드 복사
코드를 클립보드에 복사
const faq2Ko = useIntlayer("faq", { item: 2, locale: "ko" });일반적인 사용 사례
- FAQ 목록
- 가격 책정 단계 / 요금제 목록
- 캐러셀 / 슬라이더용 슬라이드 콘텐츠
- 단계별 안내 지침