์ด ํ์ด์ง์ ์ํ๋ AI ์ด์์คํดํธ๋ฅผ ์ฌ์ฉํ์ฌ ๋ฌธ์๋ฅผ ์์ฝํฉ๋๋ค
์ด ๋ฌธ์๋ ์ค๋๋์์ต๋๋ค. ๊ธฐ๋ณธ ๋ฒ์ ์ด ๋ค์ ๋ ์ง์ ์ ๋ฐ์ดํธ๋์์ต๋๋ค: 2026๋ 8์ 22์ผ.
์๋ฌธ ๋ฌธ์๋ก ์ด๋๋ฒ์ ๊ธฐ๋ก
- "usePathname ์ ํธ๋ฆฌํฐ ์ถ๊ฐ"v10.0.02026. 6. 23.
- "๋ชจ๋ exports์ ๋ํ ํตํฉ ๋ฌธ์ํ"v8.0.02026. 1. 21.
์ด ํ์ด์ง์ ์ฝํ ์ธ ๋ AI๋ฅผ ์ฌ์ฉํ์ฌ ๋ฒ์ญ๋์์ต๋๋ค.
์์ด ์๋ณธ ๋ด์ฉ์ ์ต์ ๋ฒ์ ์ ๋ณด๊ธฐ์ด ๋ฌธ์๋ฅผ ๊ฐ์ ํ ์์ด๋์ด๊ฐ ์์ผ์๋ฉด GitHub์ ํ ๋ฆฌํ์คํธ๋ฅผ ์ ์ถํ์ฌ ์์ ๋กญ๊ฒ ๊ธฐ์ฌํด ์ฃผ์ธ์.
๋ฌธ์์ ๋ํ GitHub ๋งํฌ๋ฌธ์์ Markdown์ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
next-intlayer ํจํค์ง
next-intlayer ํจํค์ง๋ Intlayer๋ฅผ Next.js ์ ํ๋ฆฌ์ผ์ด์
์ ํตํฉํ๊ธฐ ์ํ ํ์ ๋๊ตฌ๋ฅผ ์ ๊ณตํฉ๋๋ค. App Router์ Page Router ๋ ๋ค๋ฅผ ์ง์ํ๋ฉฐ, ๋ก์ผ์ผ ๊ธฐ๋ฐ ๋ผ์ฐํ
์ ์ํ ๋ฏธ๋ค์จ์ด๋ ํฌํจํฉ๋๋ค.
์ค์น
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋ด๋ณด๋ด๊ธฐ
๋ฏธ๋ค์จ์ด
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํจ์ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
intlayerMiddleware | ๋ก์ผ์ผ ๊ธฐ๋ฐ ๋ผ์ฐํ ๋ฐ ๋ฆฌ๋ค์ด๋ ํธ๋ฅผ ์ฒ๋ฆฌํ๋ Next.js ๋ฏธ๋ค์จ์ด์ ๋๋ค. ์์ฒญ ํค๋/์ฟ ํค์์ ๋ก์ผ์ผ์ ๊ฐ์งํ๊ณ ์ ์ ํ ๋ก์ผ์ผ ๊ฒฝ๋ก๋ก ๋ฆฌ๋ค์ด๋ ํธํฉ๋๋ค. | intlayerMiddleware |
๊ตฌ์ฑ ํฌํผ
๊ฐ์ ธ์ค๊ธฐ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํจ์ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
withIntlayer | Next.js ๊ตฌ์ฑ์ ๋ํํ๋ ๋น๋๊ธฐ ํฌํผ๋ก, ๋น๋ ์ ์ Intlayer ๋์ ๋๋ฆฌ๊ฐ ์ค๋น๋๋๋ก ๋ณด์ฅํฉ๋๋ค. ์ฝํ ์ธ ํ์ผ์ ์ค๋นํ๊ณ webpack/SWC ํ๋ฌ๊ทธ์ธ์ ์ค์ ํฉ๋๋ค. | - |
withIntlayerSync | ๋น๋๊ธฐ ์ฒ๋ฆฌ๊ฐ ๋ถ๊ฐ๋ฅํ๊ฑฐ๋ ์์น ์๋ ์ค์ ์ ์ ํฉํ Next.js ๊ตฌ์ฑ์ ๋๊ธฐ์ ์ผ๋ก ๋ํํ๋ ํฌํผ์ ๋๋ค. ์๋ฒ ์์ ์ ๋์ ๋๋ฆฌ๋ฅผ ์ค๋นํ์ง ์์ต๋๋ค. | - |
ํ๋ก๋ฐ์ด๋
์ํฌํธ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
๋๋
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ์ปดํฌ๋ํธ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
IntlayerClientProvider | Next.js App Router์ ํด๋ผ์ด์ธํธ ์ธก ์ปดํฌ๋ํธ๋ฅผ ์ํ Provider. react-intlayer์ IntlayerProvider๋ฅผ ๋ํํฉ๋๋ค. | - |
IntlayerServerProvider | Next.js(App Router)์ ์๋ฒ ์ธก ์ปดํฌ๋ํธ๋ฅผ ์ํ Provider. ์๋ฒ์์ locale ์ปจํ ์คํธ๋ฅผ ์ ๊ณตํฉ๋๋ค. | - |
IntlayerServer | App Router์์ Intlayer ์ฝํ ์ธ ๋ฅผ ์ํ ์๋ฒ ์ฌ์ด๋ ๋ํผ. ์๋ฒ ์ปดํฌ๋ํธ์์ ์ ์ ํ locale ์ฒ๋ฆฌ๋ฅผ ๋ณด์ฅํฉ๋๋ค. | - |
ํ (ํด๋ผ์ด์ธํธ ์ธก)
์ํฌํธ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
react-intlayer์ ๋๋ถ๋ถ์ ํ
์ ์ฌ๋ด๋ณด๋
๋๋ค.
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
useIntlayer | ํค๋ก ํ๋์ dictionary๋ฅผ ์ ํํ์ฌ ๊ทธ ๋ด์ฉ์ ๋ฐํํ๋ ํด๋ผ์ด์ธํธ ์ฌ์ด๋ ํ ์ ๋๋ค. locale์ด ์ ๊ณต๋์ง ์์ผ๋ฉด context์์ ๊ฐ์ ธ์ต๋๋ค. | useIntlayer |
useDictionary | dictionary ๊ฐ์ฒด๋ฅผ ๋ณํํ๊ณ ํ์ฌ locale์ ๋ง๋ ์ฝํ
์ธ ๋ฅผ ๋ฐํํ๋ ํ
์
๋๋ค. t() ๋ฒ์ญ, ์ด๊ฑฐํ ์ฒ๋ฆฌ ๋ฑ๋ ์ํํฉ๋๋ค. | useDictionary |
useDictionaryAsync | ๋น๋๊ธฐ ์ฌ์ ์ ์ฒ๋ฆฌํ๋ ํ ์ ๋๋ค. Promise ๊ธฐ๋ฐ์ dictionary ๋งต์ ๋ฐ์ ํ์ฌ ๋ก์ผ์ผ์ ๋ง๊ฒ ์ด๋ฅผ ํด๊ฒฐ(resolve)ํฉ๋๋ค. | - |
useDictionaryDynamic | ํค๋ก ๋ก๋๋๋ ๋์ ์ฌ์ ์ ์ฒ๋ฆฌํ๋ ํ ์ ๋๋ค. ๋ก๋ฉ ์ํ ๊ด๋ฆฌ๋ฅผ ์ํด ๋ด๋ถ์ ์ผ๋ก React Suspense๋ฅผ ์ฌ์ฉํฉ๋๋ค. | - |
useLocale | ํด๋ผ์ด์ธํธ ์ฌ์ด๋ ํ ์ผ๋ก ํ์ฌ ๋ก์ผ์ผ๊ณผ ์ด๋ฅผ ์ค์ ํ๋ ํจ์๋ฅผ ์ ๊ณตํฉ๋๋ค. Next.js App Router์ navigation ์ง์์ ์ํด ํ์ฅ๋์ด ์์ต๋๋ค. | useLocale |
usePathname | ๋ก์ผ์ผ ์ ๋์ฌ์ ๋ก์ผ์ผ ๋งค๊ฐ๋ณ์๊ฐ ์ ๊ฑฐ๋ ์ฟผ๋ฆฌ ๋งค๊ฐ๋ณ์๋ฅผ ์ ์ธํ ํ์ฌ ๊ฒฝ๋ก ์ด๋ฆ์ ๋ฐํํฉ๋๋ค. | usePathname |
useRewriteURL | URL ์ฌ์์ฑ(rewrite)์ ๊ด๋ฆฌํ๋ ํด๋ผ์ด์ธํธ ์ฌ์ด๋ ํ ์ ๋๋ค. ๋ณด๋ค ๋ณด๊ธฐ ์ข์ ๋ก์ปฌ๋ผ์ด์ฆ๋ ๋ฆฌ๋ผ์ดํธ ๊ท์น์ด ์์ผ๋ฉด URL์ ์๋์ผ๋ก ์ ๋ฐ์ดํธํฉ๋๋ค. | useRewriteURL |
useLocalePageRouter | Next.js Page Router ์ ์ฉ ๋ก์ผ์ผ ๊ด๋ฆฌ ํ ์ ๋๋ค. ๋ก์ผ์ผ ๋ณ๊ฒฝ ์ ๋ฆฌ๋๋ ์ ๋ฐ ํ์ด์ง ๋ฆฌ๋ก๋๋ฅผ ์ฒ๋ฆฌํฉ๋๋ค. | - |
useI18n | ํค๋ก ์ค์ฒฉ๋ ์ฝํ
์ธ ์ ์ ๊ทผํ๊ธฐ ์ํ ๋ฒ์ญ ํจ์ t()๋ฅผ ์ ๊ณตํ๋ ํ
์
๋๋ค. i18next/next-intl ํจํด์ ๋ชจ๋ฐฉํฉ๋๋ค. | useI18n |
useIntl | ๋ก์ผ์ผ์ ๋ฐ์ธ๋ฉ๋ Intl ๊ฐ์ฒด๋ฅผ ์ ๊ณตํ๋ ํ
. ํ์ฌ ๋ก์ผ์ผ์ ์๋์ผ๋ก ์ฃผ์
ํ๊ณ ์ต์ ํ๋ ์บ์ฑ์ ์ฌ์ฉํฉ๋๋ค. | - |
useLoadDynamic | React Suspense๋ฅผ ์ฌ์ฉํด ๋์ ์ฌ์ ์ ๋ก๋ํ๋ ํ . ํค์ ํ๋ผ๋ฏธ์ค(promise)๋ฅผ ๋ฐ์ ๊ฒฐ๊ณผ๋ฅผ ์บ์ํฉ๋๋ค. | - |
ํจ์๋ค (์๋ฒ ์ฌ์ด๋)
์ํฌํธ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํจ์ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
t | Next.js App Router์ฉ ๋ฒ์ญ ํจ์์ ์๋ฒ ์ธก ๋ฒ์ ์ ๋๋ค. ์๋ฒ ๋ก์ผ์ผ์ ๋ง๋ ๋ค๊ตญ์ด ์ฝํ ์ธ ๋ฒ์ญ์ ๋ฐํํฉ๋๋ค. | translation |
getLocale | Next.js ํค๋์ ์ฟ ํค์์ ํ์ฌ ๋ก์ผ์ผ์ ์ถ์ถํ๋ ํฌํผ ํจ์์ ๋๋ค. Server Components, Server Actions, ๋๋ Route Handlers์ฉ์ผ๋ก ์ค๊ณ๋์์ต๋๋ค. | - |
generateStaticParams | ๊ตฌ์ฑ๋ ๋ก์ผ์ผ์ ๊ธฐ๋ฐ์ผ๋ก Next.js์ ๋์ ๋ผ์ฐํธ์ ๋ํ ์ ์ ๋งค๊ฐ๋ณ์๋ฅผ ์์ฑํฉ๋๋ค. ์ฌ์ ๋ ๋๋ง์ ์ํด ๋ก์ผ์ผ ๊ฐ์ฒด์ ๋ฐฐ์ด์ ๋ฐํํฉ๋๋ค. | - |
locale | ์๋ฒ ์ปจํ ์คํธ(App Router)์์ ๋ก์ผ์ผ์ ๊ฐ์ ธ์ค๊ฑฐ๋ ์ค์ ํ๋ ํจ์์ ๋๋ค. Server Components์์ ๋ก์ผ์ผ ๊ด๋ฆฌ๋ฅผ ์ ๊ณตํฉ๋๋ค. | - |
ํ์
Import:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํ์ | ์ค๋ช |
|---|---|
NextPageIntlayer | Intlayer ์ง์์ ๊ฐ์ถ Next.js ํ์ด์ง์ฉ ํ์ . locale ๋งค๊ฐ๋ณ์๋ฅผ ํฌํจํ๋ ์ ๋ค๋ฆญ ํ์ . |
Next14PageIntlayer | Intlayer ์ง์์ ๊ฐ์ถ Next.js 14 ํ์ด์ง์ฉ ํ์ . |
Next15PageIntlayer | Intlayer ์ง์์ ๊ฐ์ถ Next.js 15 ํ์ด์ง์ฉ ํ์ . |
NextLayoutIntlayer | Intlayer ์ง์์ ๊ฐ์ถ Next.js ๋ ์ด์์์ฉ ํ์ . locale ๋งค๊ฐ๋ณ์๋ฅผ ํฌํจํ๋ ์ ๋ค๋ฆญ ํ์ . |
Next14LayoutIntlayer | Intlayer ์ง์์ด ํฌํจ๋ Next.js 14 ๋ ์ด์์์ฉ ํ์ . |
Next15LayoutIntlayer | Intlayer ์ง์์ด ํฌํจ๋ Next.js 15 ๋ ์ด์์์ฉ ํ์ . |
LocalParams | locale๋ฅผ ํฌํจํ Next.js ๋ผ์ฐํธ ๋งค๊ฐ๋ณ์์ฉ ํ์
. locale ์์ฑ์ ๊ฐ์ง ๊ฐ์ฒด. |
LocalPromiseParams | locale๋ฅผ ํฌํจํ Next.js ๋ผ์ฐํธ ๋งค๊ฐ๋ณ์์ฉ ํ์
(๋น๋๊ธฐ ๋ฒ์ ). locale ์์ฑ์ ๊ฐ์ง ๊ฐ์ฒด๋ก ํด๊ฒฐ๋๋ Promise. |
