작가:
    Aymeric PINEAU
    생성: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사전과 같은 객체(키, 콘텐츠)를 처리합니다. t() 번역, 열거형 등을 처리합니다.getDictionary
    getDictionaryAsyncFunction로케일별 로더 맵에서 사전의 단일 로케일 청크를 로드한 다음 처리합니다.getDictionaryAsync
    getIntlayerFunctiongetDictionary를 기반으로 하지만 생성된 선언에서 최적화된 사전 버전을 주입합니다.getIntlayer
    getIntlayerAsyncFunctiongetIntlayer의 비동기 대응 기능으로, 요청된 로케일만 로드합니다. 메타데이터, 로더, 서버 함수용.getIntlayerAsync

    로컬라이제이션 유틸리티

    임포트:

    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 객체입니다.
    번들 최적화getIntlayer