์ด ํ์ด์ง์ ์ํ๋ AI ์ด์์คํดํธ๋ฅผ ์ฌ์ฉํ์ฌ ๋ฌธ์๋ฅผ ์์ฝํฉ๋๋ค
์ด ๋ฌธ์๋ ์ค๋๋์์ต๋๋ค. ๊ธฐ๋ณธ ๋ฒ์ ์ด ๋ค์ ๋ ์ง์ ์ ๋ฐ์ดํธ๋์์ต๋๋ค: 2026๋ 10์ 4์ผ.
์๋ฌธ ๋ฌธ์๋ก ์ด๋๋ฒ์ ๊ธฐ๋ก
- "usePathname ์ ํธ๋ฆฌํฐ ์ถ๊ฐ"v10.0.02026. 6. 23.
- "Unified documentation for all exports"v7.5.142026. 1. 21.
์ด ํ์ด์ง์ ์ฝํ ์ธ ๋ AI๋ฅผ ์ฌ์ฉํ์ฌ ๋ฒ์ญ๋์์ต๋๋ค.
์์ด ์๋ณธ ๋ด์ฉ์ ์ต์ ๋ฒ์ ์ ๋ณด๊ธฐ์ด ๋ฌธ์๋ฅผ ๊ฐ์ ํ ์์ด๋์ด๊ฐ ์์ผ์๋ฉด GitHub์ ํ ๋ฆฌํ์คํธ๋ฅผ ์ ์ถํ์ฌ ์์ ๋กญ๊ฒ ๊ธฐ์ฌํด ์ฃผ์ธ์.
๋ฌธ์์ ๋ํ GitHub ๋งํฌ๋ฌธ์์ Markdown์ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
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.
์ค์น
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋ด๋ณด๋ด๊ธฐ
ํ๋ก๋ฐ์ด๋
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| Component | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
IntlayerProvider | ์ ํ๋ฆฌ์ผ์ด์ ์ ๊ฐ์ธ๊ณ Intlayer ์ปจํ ์คํธ๋ฅผ ์ ๊ณตํ๋ ์ฃผ์ provider์ ๋๋ค. ๊ธฐ๋ณธ์ ์ผ๋ก ์๋ํฐ ์ง์์ ํฌํจํฉ๋๋ค. | IntlayerProvider |
IntlayerProviderContent | ์๋ํฐ ๊ธฐ๋ฅ ์์ด ์ฝํ ์ธ ์๋ง ์ง์ค๋ provider ์ปดํฌ๋ํธ์ ๋๋ค. ์๊ฐ์ ์๋ํฐ(visual editor)๊ฐ ํ์ํ์ง ์์ ๋ ์ฌ์ฉํ์ธ์. | - |
HTMLProvider | HTML ๊ด๋ จ ๊ตญ์ ํ ์ค์ ์ ์ํ Provider์ ๋๋ค. HTML ํ๊ทธ์ ๋ํ ์ปดํฌ๋ํธ ์ค๋ฒ๋ผ์ด๋๋ฅผ ํ์ฉํฉ๋๋ค. | - |
ํ
์ํฌํธ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์
---------------------- | ํด๋ผ์ด์ธํธ ์ธก ํ ์ผ๋ก ํค๋ก ๋์ ๋๋ฆฌ ํ๋๋ฅผ ์ ํํ์ฌ ํด๋น ๋ก์ผ์ผ์ ๋ด์ฉ์ ๋ฐํํฉ๋๋ค. ๋ก์ผ์ผ์ด ์ ๊ณต๋์ง ์์ผ๋ฉด ์ปจํ ์คํธ์ ๋ก์ผ์ผ์ ์ฌ์ฉํฉ๋๋ค. | 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 ์ปดํฌ๋ํธ ์ค๋ฒ๋ผ์ด๋๋ฅผ ์ ๊ทผํ๊ธฐ ์ํ ํ
. | -
ํจ์
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํจ์ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
renderHTML | ์ปดํฌ๋ํธ ์ธ๋ถ์์ HTML์ ๋ ๋๋งํ๊ธฐ ์ํ ๋ ๋ฆฝํ ์ ํธ๋ฆฌํฐ์ ๋๋ค. | - |
renderMarkdown | ์ปดํฌ๋ํธ ์ธ๋ถ์์ Markdown์ ๋ ๋๋งํ๊ธฐ ์ํ ๋ ๋ฆฝํ ์ ํธ๋ฆฌํฐ์ ๋๋ค. | - |
t | ํด๋ผ์ด์ธํธ ์ธก ๋ฒ์ญ ํจ์๋ก, ์ ๊ณต๋ ๋ค๊ตญ์ด ์ฝํ ์ธ ์ ๋ฒ์ญ์ ๋ฐํํฉ๋๋ค. ์ ๊ณต๋์ง ์์ ๊ฒฝ์ฐ ์ปจํ ์คํธ์ locale์ ์ฌ์ฉํฉ๋๋ค. | ๋ฒ์ญ |
getDictionary | ์ฌ์ ๊ฐ์ฒด๋ฅผ ์ฒ๋ฆฌํ๊ณ ์ง์ ๋ ๋ก์ผ์ผ์ ๋ํ ์ฝํ
์ธ ๋ฅผ ๋ฐํํฉ๋๋ค. t() ๋ฒ์ญ, ์ด๊ฑฐํ, ๋งํฌ๋ค์ด, HTML ๋ฑ์ ์ฒ๋ฆฌํฉ๋๋ค. | - |
getIntlayer | ์์ฑ๋ ์ ์ธ์์ ํค๋ก ์ฌ์ ์ ๊ฒ์ํ๊ณ ์ง์ ๋ ๋ก์ผ์ผ์ ๋ํ ์ฝํ
์ธ ๋ฅผ ๋ฐํํฉ๋๋ค. getDictionary์ ์ต์ ํ๋ ๋ฒ์ ์
๋๋ค. | - |
setLocaleInStorage | ๊ตฌ์ฑ์ ๋ฐ๋ผ ์คํ ๋ฆฌ์ง(๋ก์ปฌ ์คํ ๋ฆฌ์ง ๋๋ ์ฟ ํค)์ ๋ก์ผ์ผ์ ์ค์ ํฉ๋๋ค. | - |
setLocaleCookie | ๋ ์ด์ ์ฌ์ฉ๋์ง ์์. ๋์ setLocaleInStorage์ ์ฌ์ฉํ์ธ์. ์ฟ ํค์ ๋ก์ผ์ผ์ ์ค์ ํฉ๋๋ค. | - |
localeInStorage | ์ ์ฅ์(local storage ๋๋ cookie)์์ locale์ ๊ฐ์ ธ์ต๋๋ค. | - |
localeCookie | ๋ ์ด์ ์ฌ์ฉ๋์ง ์์. ๋์ localeInStorage์ ์ฌ์ฉํ์ธ์. ์ฟ ํค์์ locale์ ๊ฐ์ ธ์ต๋๋ค. | - |
์ปดํฌ๋ํธ
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋๋
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
์ปดํฌ๋ํธ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
HTMLRenderer | ์ปค์คํ ์ปดํฌ๋ํธ๋ฅผ ์ฌ์ฉํ์ฌ HTML ์ฝํ ์ธ ๋ฅผ ๋ ๋๋งํฉ๋๋ค. | - |
MarkdownProvider | ๋งํฌ๋ค์ด ๋ ๋๋ง ์ปจํ ์คํธ์ฉ Provider. ๋งํฌ๋ค์ด ์์์ ๋ํ ์ปค์คํ ์ปดํฌ๋ํธ ์ค๋ฒ๋ผ์ด๋๋ฅผ ํ์ฉํฉ๋๋ค. | - |
MarkdownRenderer | ์ปค์คํ ์ปดํฌ๋ํธ๋ฅผ ์ฌ์ฉํ์ฌ ๋งํฌ๋ค์ด ์ฝํ ์ธ ๋ฅผ ๋ ๋๋งํฉ๋๋ค. ๋ชจ๋ ํ์ค ๋งํฌ๋ค์ด ๊ธฐ๋ฅ๊ณผ Intlayer ์ ์ฉ ๊ตฌ๋ฌธ์ ์ง์ํฉ๋๋ค. | MarkdownRenderer |
ํ์
Import:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํ์ | ์ค๋ช |
|---|---|
IntlayerNode | Intlayer ์ฝํ ์ธ ํธ๋ฆฌ ๋ด ๋ ธ๋๋ฅผ ๋ํ๋ด๋ ํ์ . ํ์ ์์ ํ ์ฝํ ์ธ ์กฐ์์ ์ฌ์ฉ๋ฉ๋๋ค. |
์๋ฒ ์ธก (react-intlayer/server)
Import:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| Export | Type | Description |
|---|---|---|
IntlayerServerProvider | Component | ์๋ฒ ์ธก ๋ ๋๋ง์ ์ํ Provider. |
IntlayerServer | Component | Intlayer ์ฝํ ์ธ ์ ์๋ฒ ์ธก ๋ํผ. |
t | Function | ๋ฒ์ญ ํจ์์ ์๋ฒ ์ธก ๋ฒ์ . |
useLocale | Hook | ์๋ฒ ์ธก์์ ๋ก์ผ์ผ์ ์ ๊ทผํ๊ธฐ ์ํ Hook. |
useHTMLRenderer | ์ฌ์ ๊ตฌ์ฑ๋ HTML ๋ ๋๋ฌ ํจ์๋ฅผ ๊ฐ์ ธ์ค๋ ํ ์ ๋๋ค. | - |
useMarkdownRenderer | ์ฌ์ ๊ตฌ์ฑ๋ Markdown ๋ ๋๋ฌ ํจ์๋ฅผ ๊ฐ์ ธ์ค๋ ํ ์ ๋๋ค. | - |
useIntlayer | Hook | ์๋ฒ ์ธก ๋ฒ์ ์ useIntlayer. |
useDictionary | Hook | ์๋ฒ ์ธก ๋ฒ์ ์ useDictionary. |
useI18n | Hook | ์๋ฒ ์ธก ๋ฒ์ ์ useI18n. |
locale | Function | ์๋ฒ ์ธก์์ ๋ก์ผ์ผ์ ๊ฐ์ ธ์ค๊ฑฐ๋ ์ค์ ํ๋ ํจ์. |
