์ž‘๊ฐ€:
    ์ƒ์„ฑ:2026-01-21๋งˆ์ง€๋ง‰ ์—…๋ฐ์ดํŠธ:2026-01-21

    react-intlayer ํŒจํ‚ค์ง€

    The react-intlayer package provides the necessary tools to integrate Intlayer into React applications. It includes context providers, hooks, and components for handling multilingual content.

    ์„ค์น˜

    bash
    npm install react-intlayer
    

    ๋‚ด๋ณด๋‚ด๊ธฐ

    ํ”„๋กœ๋ฐ”์ด๋”

    ๊ฐ€์ ธ์˜ค๊ธฐ:

    tsx
    import "react-intlayer";
    
    Component์„ค๋ช…๊ด€๋ จ ๋ฌธ์„œ
    IntlayerProvider์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๊ฐ์‹ธ๊ณ  Intlayer ์ปจํ…์ŠคํŠธ๋ฅผ ์ œ๊ณตํ•˜๋Š” ์ฃผ์š” provider์ž…๋‹ˆ๋‹ค. ๊ธฐ๋ณธ์ ์œผ๋กœ ์—๋””ํ„ฐ ์ง€์›์„ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค.IntlayerProvider
    IntlayerProviderContent์—๋””ํ„ฐ ๊ธฐ๋Šฅ ์—†์ด ์ฝ˜ํ…์ธ ์—๋งŒ ์ง‘์ค‘๋œ provider ์ปดํฌ๋„ŒํŠธ์ž…๋‹ˆ๋‹ค. ์‹œ๊ฐ์  ์—๋””ํ„ฐ(visual editor)๊ฐ€ ํ•„์š”ํ•˜์ง€ ์•Š์„ ๋•Œ ์‚ฌ์šฉํ•˜์„ธ์š”.-
    HTMLProviderHTML ๊ด€๋ จ ๊ตญ์ œํ™” ์„ค์ •์„ ์œ„ํ•œ Provider์ž…๋‹ˆ๋‹ค. HTML ํƒœ๊ทธ์— ๋Œ€ํ•œ ์ปดํฌ๋„ŒํŠธ ์˜ค๋ฒ„๋ผ์ด๋“œ๋ฅผ ํ—ˆ์šฉํ•ฉ๋‹ˆ๋‹ค.-

    ํ›…

    ์ž„ํฌํŠธ:

    tsx
    import "react-intlayer";
    

    ํ›… | ์„ค๋ช… | ๊ด€๋ จ ๋ฌธ์„œ

    ---------------------- | ํด๋ผ์ด์–ธํŠธ ์ธก ํ›…์œผ๋กœ ํ‚ค๋กœ ๋”•์…”๋„ˆ๋ฆฌ ํ•˜๋‚˜๋ฅผ ์„ ํƒํ•˜์—ฌ ํ•ด๋‹น ๋กœ์ผ€์ผ์˜ ๋‚ด์šฉ์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. ๋กœ์ผ€์ผ์ด ์ œ๊ณต๋˜์ง€ ์•Š์œผ๋ฉด ์ปจํ…์ŠคํŠธ์˜ ๋กœ์ผ€์ผ์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. | useIntlayer

    useDictionary | ๋”•์…”๋„ˆ๋ฆฌ ๊ฐ์ฒด๋ฅผ ๋ณ€ํ™˜ํ•˜๊ณ  ํ˜„์žฌ ๋กœ์ผ€์ผ์˜ ๋‚ด์šฉ์„ ๋ฐ˜ํ™˜ํ•˜๋Š” ํ›…. t() ๋ฒˆ์—ญ, enumerations ๋“ฑ์„ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค. | useDictionary

    useDictionaryAsync | ๋น„๋™๊ธฐ ๋”•์…”๋„ˆ๋ฆฌ๋ฅผ ์ฒ˜๋ฆฌํ•˜๋Š” ํ›…. ํ”„๋กœ๋ฏธ์Šค ๊ธฐ๋ฐ˜ ๋”•์…”๋„ˆ๋ฆฌ ๋งต์„ ๋ฐ›์•„ ํ˜„์žฌ ๋กœ์ผ€์ผ์— ๋Œ€ํ•ด ์ด๋ฅผ ํ•ด๊ฒฐํ•ฉ๋‹ˆ๋‹ค. | -

    useDictionaryDynamic | ํ‚ค(key)๋กœ ๋กœ๋“œ๋˜๋Š” ๋™์  ๋”•์…”๋„ˆ๋ฆฌ๋ฅผ ์ฒ˜๋ฆฌํ•˜๋Š” ํ›…์ž…๋‹ˆ๋‹ค. ๋‚ด๋ถ€์ ์œผ๋กœ ๋กœ๋”ฉ ์ƒํƒœ๋ฅผ ์œ„ํ•ด React Suspense๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. | -

    useLocale | ํด๋ผ์ด์–ธํŠธ ์ธก ํ›…์œผ๋กœ ํ˜„์žฌ ๋กœ์ผ€์ผ, ๊ธฐ๋ณธ ๋กœ์ผ€์ผ, ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๋กœ์ผ€์ผ๋“ค, ๊ทธ๋ฆฌ๊ณ  ๋กœ์ผ€์ผ์„ ์—…๋ฐ์ดํŠธํ•˜๋Š” ํ•จ์ˆ˜๋ฅผ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค. | useLocale

    useLocaleBase | ์ปจํ…์ŠคํŠธ์—์„œ ํ˜„์žฌ ๋กœ์ผ€์ผ๊ณผ ๊ด€๋ จ๋œ ๋ชจ๋“  ํ•„๋“œ(locale, defaultLocale, availableLocales, setLocale)๋ฅผ ๊ฐ€์ ธ์˜ค๋Š” ํ›…. | -

    usePathname | ๋กœ์ผ€์ผ ์„ธ๊ทธ๋จผํŠธ๊ฐ€ ์ œ๊ฑฐ๋œ ํ˜„์žฌ ๊ฒฝ๋กœ ์ด๋ฆ„(pathname)์„ ๋ฐ˜ํ™˜ํ•˜๋Š” Hook. popstate๋ฅผ ํ†ตํ•ด ๋ธŒ๋ผ์šฐ์ € ํƒ์ƒ‰์— ๋ฐ˜์‘ํ•ฉ๋‹ˆ๋‹ค. | usePathname

    useRewriteURL | URL ์žฌ์ž‘์„ฑ์„ ๊ด€๋ฆฌํ•˜๋Š” ํด๋ผ์ด์–ธํŠธ ์ธก ํ›…. ํ˜„์žฌ pathname๊ณผ ๋กœ์ผ€์ผ์— ๋Œ€ํ•œ rewrite ๊ทœ์น™์ด ์กด์žฌํ•˜๋ฉด URL์„ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค. | useRewriteURL

    useI18n | ํ‚ค๋กœ ์ค‘์ฒฉ๋œ ์ฝ˜ํ…์ธ ์— ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ๋Š” ๋ฒˆ์—ญ ํ•จ์ˆ˜ t()์„ ์ œ๊ณตํ•˜๋Š” ํ›…. i18next/next-intl ํŒจํ„ด์„ ๋”ฐ๋ฆ„. | useI18n

    useIntl | ๋กœ์ผ€์ผ์— ๋ฐ”์ธ๋”ฉ๋œ Intl ๊ฐ์ฒด๋ฅผ ์ œ๊ณตํ•˜๋Š” ํ›…. ํ˜„์žฌ ๋กœ์ผ€์ผ์„ ์ž๋™์œผ๋กœ ์ฃผ์ž…ํ•˜๊ณ  ์ตœ์ ํ™”๋œ ์บ์‹ฑ์„ ์‚ฌ์šฉํ•จ. | -

    useLocaleStorage | ๋กœ์ปฌ ์Šคํ† ๋ฆฌ์ง€ ๋˜๋Š” ์ฟ ํ‚ค์— ๋กœ์ผ€์ผ์„ ์ €์žฅํ•ด ์ง€์†์„ฑ์„ ์ œ๊ณตํ•˜๋Š” ํ›…์ž…๋‹ˆ๋‹ค. getter ๋ฐ setter ํ•จ์ˆ˜๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. | -

    useLocaleCookie | ๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋Œ€์‹  useLocaleStorage๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”. ์ฟ ํ‚ค์— ๋กœ์ผ€์ผ ์ง€์†์„ฑ์„ ๊ด€๋ฆฌํ•˜๋Š” ํ›…์ž…๋‹ˆ๋‹ค. | -

    useLoadDynamic | React Suspense๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋™์  ๋”•์…”๋„ˆ๋ฆฌ๋ฅผ ๋กœ๋“œํ•˜๋Š” ํ›…. ํ‚ค์™€ Promise๋ฅผ ๋ฐ›์•„ ๊ฒฐ๊ณผ๋ฅผ ์บ์‹œํ•ฉ๋‹ˆ๋‹ค. | -

    useIntlayerContext | ํ˜„์žฌ Intlayer ํด๋ผ์ด์–ธํŠธ ์ปจํ…์ŠคํŠธ ๊ฐ’(locale, setLocale ๋“ฑ)์„ ์ œ๊ณตํ•˜๋Š” ํ›…. | -

    useHTMLContext | HTMLProvider ์ปจํ…์ŠคํŠธ์—์„œ HTML ์ปดํฌ๋„ŒํŠธ ์˜ค๋ฒ„๋ผ์ด๋“œ๋ฅผ ์ ‘๊ทผํ•˜๊ธฐ ์œ„ํ•œ ํ›…. | -

    ํ•จ์ˆ˜

    ๊ฐ€์ ธ์˜ค๊ธฐ:

    tsx
    import "react-intlayer";
    
    ํ•จ์ˆ˜์„ค๋ช…๊ด€๋ จ ๋ฌธ์„œ
    renderHTML์ปดํฌ๋„ŒํŠธ ์™ธ๋ถ€์—์„œ HTML์„ ๋ Œ๋”๋งํ•˜๊ธฐ ์œ„ํ•œ ๋…๋ฆฝํ˜• ์œ ํ‹ธ๋ฆฌํ‹ฐ์ž…๋‹ˆ๋‹ค.-
    renderMarkdown์ปดํฌ๋„ŒํŠธ ์™ธ๋ถ€์—์„œ Markdown์„ ๋ Œ๋”๋งํ•˜๊ธฐ ์œ„ํ•œ ๋…๋ฆฝํ˜• ์œ ํ‹ธ๋ฆฌํ‹ฐ์ž…๋‹ˆ๋‹ค.-
    tํด๋ผ์ด์–ธํŠธ ์ธก ๋ฒˆ์—ญ ํ•จ์ˆ˜๋กœ, ์ œ๊ณต๋œ ๋‹ค๊ตญ์–ด ์ฝ˜ํ…์ธ ์˜ ๋ฒˆ์—ญ์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. ์ œ๊ณต๋˜์ง€ ์•Š์„ ๊ฒฝ์šฐ ์ปจํ…์ŠคํŠธ์˜ locale์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.๋ฒˆ์—ญ
    getDictionary์‚ฌ์ „ ๊ฐ์ฒด๋ฅผ ์ฒ˜๋ฆฌํ•˜๊ณ  ์ง€์ •๋œ ๋กœ์ผ€์ผ์— ๋Œ€ํ•œ ์ฝ˜ํ…์ธ ๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. t() ๋ฒˆ์—ญ, ์—ด๊ฑฐํ˜•, ๋งˆํฌ๋‹ค์šด, HTML ๋“ฑ์„ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.-
    getIntlayer์ƒ์„ฑ๋œ ์„ ์–ธ์—์„œ ํ‚ค๋กœ ์‚ฌ์ „์„ ๊ฒ€์ƒ‰ํ•˜๊ณ  ์ง€์ •๋œ ๋กœ์ผ€์ผ์— ๋Œ€ํ•œ ์ฝ˜ํ…์ธ ๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. getDictionary์˜ ์ตœ์ ํ™”๋œ ๋ฒ„์ „์ž…๋‹ˆ๋‹ค.-
    setLocaleInStorage๊ตฌ์„ฑ์— ๋”ฐ๋ผ ์Šคํ† ๋ฆฌ์ง€(๋กœ์ปฌ ์Šคํ† ๋ฆฌ์ง€ ๋˜๋Š” ์ฟ ํ‚ค)์— ๋กœ์ผ€์ผ์„ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค.-
    setLocaleCookie๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š์Œ. ๋Œ€์‹  setLocaleInStorage์„ ์‚ฌ์šฉํ•˜์„ธ์š”. ์ฟ ํ‚ค์— ๋กœ์ผ€์ผ์„ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค.-
    localeInStorage์ €์žฅ์†Œ(local storage ๋˜๋Š” cookie)์—์„œ locale์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.-
    localeCookie๋” ์ด์ƒ ์‚ฌ์šฉ๋˜์ง€ ์•Š์Œ. ๋Œ€์‹  localeInStorage์„ ์‚ฌ์šฉํ•˜์„ธ์š”. ์ฟ ํ‚ค์—์„œ locale์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.-

    ์ปดํฌ๋„ŒํŠธ

    ๊ฐ€์ ธ์˜ค๊ธฐ:

    tsx
    import "react-intlayer";
    

    ๋˜๋Š”

    tsx
    import "react-intlayer/markdown";
    
    ์ปดํฌ๋„ŒํŠธ์„ค๋ช…๊ด€๋ จ ๋ฌธ์„œ
    HTMLRenderer์ปค์Šคํ…€ ์ปดํฌ๋„ŒํŠธ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ HTML ์ฝ˜ํ…์ธ ๋ฅผ ๋ Œ๋”๋งํ•ฉ๋‹ˆ๋‹ค.-
    MarkdownProvider๋งˆํฌ๋‹ค์šด ๋ Œ๋”๋ง ์ปจํ…์ŠคํŠธ์šฉ Provider. ๋งˆํฌ๋‹ค์šด ์š”์†Œ์— ๋Œ€ํ•œ ์ปค์Šคํ…€ ์ปดํฌ๋„ŒํŠธ ์˜ค๋ฒ„๋ผ์ด๋“œ๋ฅผ ํ—ˆ์šฉํ•ฉ๋‹ˆ๋‹ค.-
    MarkdownRenderer์ปค์Šคํ…€ ์ปดํฌ๋„ŒํŠธ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋งˆํฌ๋‹ค์šด ์ฝ˜ํ…์ธ ๋ฅผ ๋ Œ๋”๋งํ•ฉ๋‹ˆ๋‹ค. ๋ชจ๋“  ํ‘œ์ค€ ๋งˆํฌ๋‹ค์šด ๊ธฐ๋Šฅ๊ณผ Intlayer ์ „์šฉ ๊ตฌ๋ฌธ์„ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.MarkdownRenderer

    ํƒ€์ž…

    Import:

    tsx
    import "react-intlayer";
    
    ํƒ€์ž…์„ค๋ช…
    IntlayerNodeIntlayer ์ฝ˜ํ…์ธ  ํŠธ๋ฆฌ ๋‚ด ๋…ธ๋“œ๋ฅผ ๋‚˜ํƒ€๋‚ด๋Š” ํƒ€์ž…. ํƒ€์ž… ์•ˆ์ „ํ•œ ์ฝ˜ํ…์ธ  ์กฐ์ž‘์— ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค.

    ์„œ๋ฒ„ ์ธก (react-intlayer/server)

    Import:

    tsx
    import "react-intlayer/server";
    
    ExportTypeDescription
    IntlayerServerProviderComponent์„œ๋ฒ„ ์ธก ๋ Œ๋”๋ง์„ ์œ„ํ•œ Provider.
    IntlayerServerComponentIntlayer ์ฝ˜ํ…์ธ ์˜ ์„œ๋ฒ„ ์ธก ๋ž˜ํผ.
    tFunction๋ฒˆ์—ญ ํ•จ์ˆ˜์˜ ์„œ๋ฒ„ ์ธก ๋ฒ„์ „.
    useLocaleHook์„œ๋ฒ„ ์ธก์—์„œ ๋กœ์ผ€์ผ์— ์ ‘๊ทผํ•˜๊ธฐ ์œ„ํ•œ Hook.
    useHTMLRenderer์‚ฌ์ „ ๊ตฌ์„ฑ๋œ HTML ๋ Œ๋”๋Ÿฌ ํ•จ์ˆ˜๋ฅผ ๊ฐ€์ ธ์˜ค๋Š” ํ›…์ž…๋‹ˆ๋‹ค.-
    useMarkdownRenderer์‚ฌ์ „ ๊ตฌ์„ฑ๋œ Markdown ๋ Œ๋”๋Ÿฌ ํ•จ์ˆ˜๋ฅผ ๊ฐ€์ ธ์˜ค๋Š” ํ›…์ž…๋‹ˆ๋‹ค.-
    useIntlayerHook์„œ๋ฒ„ ์ธก ๋ฒ„์ „์˜ useIntlayer.
    useDictionaryHook์„œ๋ฒ„ ์ธก ๋ฒ„์ „์˜ useDictionary.
    useI18nHook์„œ๋ฒ„ ์ธก ๋ฒ„์ „์˜ useI18n.
    localeFunction์„œ๋ฒ„ ์ธก์—์„œ ๋กœ์ผ€์ผ์„ ๊ฐ€์ ธ์˜ค๊ฑฐ๋‚˜ ์„ค์ •ํ•˜๋Š” ํ•จ์ˆ˜.