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

    intlayer ํŒจํ‚ค์ง€

    intlayer ํŒจํ‚ค์ง€๋Š” Intlayer ์—์ฝ”์‹œ์Šคํ…œ์˜ ํ•ต์‹ฌ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์ž…๋‹ˆ๋‹ค. JavaScript ๋ฐ TypeScript ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์—์„œ ๋‹ค๊ตญ์–ด ์ฝ˜ํ…์ธ ๋ฅผ ๊ด€๋ฆฌํ•˜๊ธฐ ์œ„ํ•œ ํ•„์ˆ˜ ํ•จ์ˆ˜, ํƒ€์ž… ๋ฐ ์œ ํ‹ธ๋ฆฌํ‹ฐ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

    ์„ค์น˜

    bash
    npm install intlayer
    

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

    ๊ตฌ์„ฑ

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

    tsx
    import "intlayer";
    
    ๋ณ€์ˆ˜ํƒ€์ž…์„ค๋ช…๊ด€๋ จ ๋ฌธ์„œ
    configurationIntlayerConfigIntlayer ๊ตฌ์„ฑ ๊ฐ์ฒด.getConfiguration
    getConfiguration() => IntlayerConfigIntlayer ๊ตฌ์„ฑ ๊ฐ์ฒด๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. (์‚ฌ์šฉ ์ค‘๋‹จ: ๋Œ€์‹  configuration์„ ์‚ฌ์šฉํ•˜์„ธ์š”)getConfiguration
    localesLocales[]์ง€์›๋˜๋Š” ๋ชจ๋“  ๋กœ์ผ€์ผ ๋ชฉ๋ก์ž…๋‹ˆ๋‹ค.-
    requiredLocalesLocales[]ํ•„์ˆ˜ ๋กœ์ผ€์ผ ๋ชฉ๋ก์ž…๋‹ˆ๋‹ค.-
    defaultLocaleLocales๊ธฐ๋ณธ ๋กœ์ผ€์ผ.-

    ํƒ€์ž…

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

    tsx
    import "intlayer";
    
    ํƒ€์ž…์„ค๋ช…
    Dictionary์‚ฌ์ „์˜ ๊ตฌ์กฐ๋ฅผ ์ •์˜ํ•˜๋Š” ๋ฐ ์‚ฌ์šฉ๋˜๋Š” Dictionary ํƒ€์ž…์ž…๋‹ˆ๋‹ค.
    DeclarationContent(Deprecated) ๋Œ€์‹  Dictionary<T>๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.
    IntlayerConfigIntlayer ๊ตฌ์„ฑ์„ ์ •์˜ํ•˜๋Š” ํƒ€์ž…์ž…๋‹ˆ๋‹ค.
    ContentNode๋”•์…”๋„ˆ๋ฆฌ ์ฝ˜ํ…์ธ ์˜ ๋…ธ๋“œ์ž…๋‹ˆ๋‹ค.
    Locale๋กœ์ผ€์ผ์„ ๋‚˜ํƒ€๋‚ด๋Š” ํƒ€์ž…์ž…๋‹ˆ๋‹ค.
    LocalesValues๋กœ์ผ€์ผ์— ๋Œ€ํ•œ ๊ฐ€๋Šฅํ•œ ๊ฐ’๋“ค์ž…๋‹ˆ๋‹ค.
    StrictModeLocaleMap์—„๊ฒฉํ•œ ํƒ€์ž… ๊ฒ€์‚ฌ์™€ ํ•จ๊ป˜ํ•˜๋Š” ๋กœ์ผ€์ผ ๋งต์ž…๋‹ˆ๋‹ค.

    ์ฝ˜ํ…์ธ  ํ•จ์ˆ˜

    Import:

    tsx
    import "intlayer";
    
    ํ•จ์ˆ˜ํƒ€์ž…์„ค๋ช…๊ด€๋ จ ๋ฌธ์„œ
    t / getTranslationFunctionํ˜„์žฌ ๋กœ์ผ€์ผ์„ ๊ธฐ๋ฐ˜์œผ๋กœ ์ฝ˜ํ…์ธ ๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.๋ฒˆ์—ญ
    enu / getEnumerationFunction์ˆ˜๋Ÿ‰์„ ๊ธฐ๋ฐ˜์œผ๋กœ ์ฝ˜ํ…์ธ ๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.์ˆ˜๋Ÿ‰
    cond / getConditionFunction๋ถˆ๋ฆฌ์–ธ ์กฐ๊ฑด์— ๋”ฐ๋ผ ์ฝ˜ํ…์ธ ๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.์กฐ๊ฑด
    genderFunction์„ฑ๋ณ„์— ๋”ฐ๋ผ ์ฝ˜ํ…์ธ ๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.์„ฑ๋ณ„
    insertFunction์ฝ˜ํ…์ธ  ๋ฌธ์ž์—ด์— ๊ฐ’์„ ์‚ฝ์ž…ํ•ฉ๋‹ˆ๋‹ค.์‚ฝ์ž…
    nest / getNestingFunction๋‹ค๋ฅธ ๋”•์…”๋„ˆ๋ฆฌ๋ฅผ ์ค‘์ฒฉํ•ฉ๋‹ˆ๋‹ค.nesting
    mdFunctionMarkdown ์ฝ˜ํ…์ธ ๋ฅผ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.markdown
    htmlFunctionHTML ์ฝ˜ํ…์ธ ๋ฅผ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.html
    fileFunctionํŒŒ์ผ ๋‚ด์šฉ์„ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.file
    getDictionaryFunction๋”•์…”๋„ˆ๋ฆฌ์ฒ˜๋Ÿผ ๋ณด์ด๋Š” ๊ฐ์ฒด(key, content)๋ฅผ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค. t() ๋ฒˆ์—ญ, enumerations ๋“ฑ๋„ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.-
    getIntlayerFunctiongetDictionary๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ํ•˜์ง€๋งŒ ์ƒ์„ฑ๋œ ์„ ์–ธ์œผ๋กœ๋ถ€ํ„ฐ ๋”•์…”๋„ˆ๋ฆฌ์˜ ์ตœ์ ํ™”๋œ ๋ฒ„์ „์„ ์ฃผ์ž…ํ•ฉ๋‹ˆ๋‹ค.-

    ๋กœ์ปฌ๋ผ์ด์ œ์ด์…˜ ์œ ํ‹ธ๋ฆฌํ‹ฐ

    ์ž„ํฌํŠธ:

    tsx
    import "intlayer";
    
    ํ•จ์ˆ˜ํƒ€์ž…์„ค๋ช…๊ด€๋ จ ๋ฌธ์„œ
    getLocaleFunction๋ฌธ์ž์—ด ๋˜๋Š” ๊ฒฝ๋กœ์—์„œ ๋กœ์ผ€์ผ์„ ๊ฐ์ง€ํ•ฉ๋‹ˆ๋‹ค.getLocale
    getLocaleLangFunction๋กœ์ผ€์ผ์˜ ์–ธ์–ด ๋ถ€๋ถ„์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.getLocaleLang
    getLocaleNameFunction๋กœ์ผ€์ผ์˜ ํ‘œ์‹œ ์ด๋ฆ„์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.getLocaleName
    getLocalizedPathFunctioncanonical ๊ฒฝ๋กœ๋ฅผ localized ๊ฒฝ๋กœ๋กœ ๋ณ€ํ™˜ํ•ฉ๋‹ˆ๋‹ค.getLocalizedPath
    getCanonicalPathFunction๋กœ์ปฌํ™”๋œ ๊ฒฝ๋กœ๋ฅผ ์ •๊ทœ ๊ฒฝ๋กœ๋กœ ๋ณ€ํ™˜ํ•ฉ๋‹ˆ๋‹ค.getCanonicalPath
    getLocalizedUrlFunctionํ˜„์ง€ํ™”๋œ URL์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.getLocalizedUrl
    getMultilingualUrlsFunction์ง€์›๋˜๋Š” ๋ชจ๋“  ๋กœ์ผ€์ผ์— ๋Œ€ํ•œ URL์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.getMultilingualUrls
    getPathWithoutLocaleFunction๊ฒฝ๋กœ์—์„œ ๋กœ์ผ€์ผ ์ ‘๋‘์‚ฌ๋ฅผ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค.getPathWithoutLocale
    getPrefixFunction๊ฒฝ๋กœ์—์„œ ๋กœ์ผ€์ผ ์ ‘๋‘์‚ฌ๋ฅผ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.getPrefix
    comparePathsFunction๋กœ์ผ€์ผ์„ ๋ฌด์‹œํ•˜๊ณ  ๋‘ ๊ฒฝ๋กœ๋ฅผ ๋น„๊ตํ•ฉ๋‹ˆ๋‹ค.comparePaths
    normalizePathFunction๊ฒฝ๋กœ๋ฅผ ๋กœ์ผ€์ผ ๋…๋ฆฝ์ ์ธ ๊ฒฝ๋กœ๋กœ ์ •๊ทœํ™”ํ•ฉ๋‹ˆ๋‹ค.comparePaths
    getHTMLTextDirFunctionํ…์ŠคํŠธ ๋ฐฉํ–ฅ(LTR/RTL)์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.getHTMLTextDir
    validatePrefixFunction๋กœ์ผ€์ผ ์ ‘๋‘์‚ฌ๋ฅผ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.validatePrefix

    ๋ธŒ๋ผ์šฐ์ € ์œ ํ‹ธ๋ฆฌํ‹ฐ

    ์ž„ํฌํŠธ:

    tsx
    import "intlayer";
    
    ํ•จ์ˆ˜์œ ํ˜•์„ค๋ช…
    getBrowserLocaleFunction๋ธŒ๋ผ์šฐ์ €์˜ ์„ ํ˜ธ ๋กœ์ผ€์ผ์„ ๊ฐ์ง€ํ•ฉ๋‹ˆ๋‹ค.
    getCookieFunction์ฟ ํ‚ค ๊ฐ’์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.
    getLocaleFromStorageFunction์Šคํ† ๋ฆฌ์ง€์—์„œ ๋กœ์ผ€์ผ์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.
    setLocaleInStorageFunction์Šคํ† ๋ฆฌ์ง€์— ๋กœ์ผ€์ผ์„ ์ €์žฅํ•ฉ๋‹ˆ๋‹ค.

    ํฌ๋งทํ„ฐ

    ์ž„ํฌํŠธ:

    tsx
    import "intlayer";
    
    ํ•จ์ˆ˜์„ค๋ช…
    number์ˆซ์ž๋ฅผ ํฌ๋งทํ•ฉ๋‹ˆ๋‹ค.
    currencyํ†ตํ™” ๊ฐ’์„ ํฌ๋งทํ•ฉ๋‹ˆ๋‹ค.
    percentage๋ฐฑ๋ถ„์œจ์„ ํฌ๋งทํ•ฉ๋‹ˆ๋‹ค.
    compact์ˆซ์ž๋ฅผ ์ถ•์•ฝ ํ˜•์‹์œผ๋กœ ํฌ๋งทํ•ฉ๋‹ˆ๋‹ค.
    date๋‚ ์งœ๋ฅผ ํฌ๋งทํ•ฉ๋‹ˆ๋‹ค.
    relativeTime์ƒ๋Œ€ ์‹œ๊ฐ„์„ ํฌ๋งทํ•ฉ๋‹ˆ๋‹ค.
    units๋‹จ์œ„๋ฅผ ํฌํ•จํ•œ ๊ฐ’์„ ํฌ๋งทํ•ฉ๋‹ˆ๋‹ค.
    Intlํ‘œ์ค€ Intl ๊ฐ์ฒด์ž…๋‹ˆ๋‹ค.