작가:
    생성:2026-09-19마지막 업데이트:2026-09-19

    remix-intlayer 패키지

    remix-intlayer 패키지는 Remix 3 애플리케이션에 Intlayer를 통합하기 위한 도구를 제공합니다. 요청 로케일 감지를 위한 미들웨어, 요청 컨텍스트 접근, 사전 조회 및 로케일 관리를 위한 훅을 포함합니다.

    설치

    bash
    npm install remix-intlayer
    

    패키지 내보내기

    미들웨어

    가져오기:

    tsx
    import { intlayer } from "remix-intlayer";
    
    내보내기타입설명관련 문서
    intlayer미들웨어 함수요청 로케일을 감지하고, 리다이렉션을 처리하며, 요청 컨텍스트를 채우는 Remix 3 미들웨어입니다.intlayer 미들웨어

    컨텍스트 스토리지

    가져오기:

    tsx
    import { Intlayer, INTLAYER_CONTEXT_PROPERTY } from "remix-intlayer";
    
    내보내기타입설명관련 문서
    IntlayerRequestContext 키 / 스토리지Remix 3 요청 컨텍스트(context.get(Intlayer))에서 Intlayer 상태를 가져오는 데 사용되는 요청 컨텍스트 키입니다.Intlayer 컨텍스트
    INTLAYER_CONTEXT_PROPERTYstring요청 컨텍스트에 직접 설치된 프로퍼티 이름('intlayer')으로, context.intlayer 및 context.get(Intlayer)를 통해 접근할 수 있습니다.-

    훅

    가져오기:

    tsx
    import { useIntlayer, useDictionary, useLocale } from "remix-intlayer";
    
    내보내기타입설명관련 문서
    useIntlayer훅현재 요청 로케일에 맞춰 키로 지정된 사전 콘텐츠를 조회하고 해결합니다.useIntlayer 훅
    useDictionary훅사전에 가져온 사전 객체에서 현재 요청 로케일에 해당하는 콘텐츠를 반환합니다.useDictionary 훅
    useLocale훅현재 요청 로케일, 기본 로케일 및 프로젝트에서 사용 가능한 전체 로케일 목록에 대한 접근을 제공합니다.useLocale 훅

    유틸리티

    가져오기:

    tsx
    import { createLocaleRouting, getIntlayerState } from "remix-intlayer";
    
    함수설명관련 문서
    createLocaleRouting요청, 구성 및 옵션이 주어졌을 때 로케일 라우팅 결정(redirect, rewrite 또는 pass)을 계산하는 순수 함수입니다.-
    getIntlayerStateReact 컴포넌트 외부에서 AsyncLocalStorage 요청 범위의 현재 IntlayerState(locale, defaultLocale, availableLocales)를 읽습니다.-

    포맷터 (remix-intlayer/format)

    가져오기:

    tsx
    import {
      useIntl,
      useDate,
      useNumber,
      useCurrency,
      usePercentage,
      useRelativeTime,
      useList,
      useUnit,
      useCompact,
    } from "remix-intlayer/format";
    
    훅설명
    useIntl캐싱 및 구독 기능과 함께 요청 또는 클라이언트 로케일에 바인딩된 Intl 인스턴스를 반환합니다.
    useDate현재 로케일에 미리 바인딩된 날짜 형식화 함수를 반환합니다 (Intl.DateTimeFormat).
    useNumber현재 로케일에 미리 바인딩된 숫자 형식화 함수를 반환합니다 (Intl.NumberFormat).
    useCurrency현재 로케일에 미리 바인딩된 통화 형식화 함수를 반환합니다.
    usePercentage현재 로케일에 미리 바인딩된 백분율 형식화 함수를 반환합니다.
    useRelativeTime현재 로케일에 미리 바인딩된 상대 시간 형식화 함수를 반환합니다 (Intl.RelativeTimeFormat).
    useList현재 로케일에 미리 바인딩된 목록 형식화 함수를 반환합니다 (Intl.ListFormat).
    useUnit현재 로케일에 미리 바인딩된 단위 형식화 함수를 반환합니다.
    useCompact현재 로케일에 미리 바인딩된 컴팩트 숫자 형식화 함수를 반환합니다 (예: 1.5K).

    HTML 유틸리티 (remix-intlayer/html)

    가져오기:

    tsx
    import { renderHTML, useHTML, useHTMLRenderer } from "remix-intlayer/html";
    
    내보내기타입설명
    renderHTMLFunctionHTML 노드를 렌더링하기 위한 독립 실행형 유틸리티 함수입니다.
    useHTMLHookHTML 프로바이더 컨텍스트 및 구성을 가져오는 훅입니다.
    useHTMLRendererHook사전 구성된 HTML 렌더러 함수를 가져오는 훅입니다.

    Markdown 유틸리티 (remix-intlayer/markdown)

    가져오기:

    tsx
    import {
      compileMarkdown,
      renderMarkdown,
      parseMarkdown,
      useMarkdown,
      useMarkdownRenderer,
    } from "remix-intlayer/markdown";
    
    내보내기타입설명
    compileMarkdownFunction마크다운 문자열을 구조화된 표현으로 컴파일합니다.
    renderMarkdownFunction마크다운 콘텐츠를 출력 노드로 렌더링합니다.
    parseMarkdownFunction원시 마크다운 콘텐츠를 AST로 구문 분석합니다.
    useMarkdownHook마크다운 프로바이더 컨텍스트를 가져오는 훅입니다.
    useMarkdownRendererHook사전 구성된 Markdown 렌더러 함수를 가져오는 훅입니다.

    타입

    가져오기:

    tsx
    import type {
      IntlayerState,
      IntlayerMiddlewareOptions,
      LocaleRoutingOptions,
      LocaleRoutingAction,
      LocaleRoutingRequest,
      UseLocaleResult,
    } from "remix-intlayer";
    
    타입설명
    IntlayerStateRemix 요청 컨텍스트에 저장된 locale, defaultLocale 및 availableLocales를 포함하는 상태 객체입니다.
    IntlayerMiddlewareOptionsintlayer() 미들웨어에 전달되는 구성 옵션입니다.
    LocaleRoutingOptions로케일 접두사, 감지 및 리디렉션을 사용자 정의하는 옵션입니다.
    LocaleRoutingAction라우팅 결정을 나타내는 구별된 유니온: redirect, rewrite 또는 pass.
    LocaleRoutingRequestcreateLocaleRouting에 필요한 최소한의 요청 표현입니다.
    UseLocaleResultlocale, defaultLocale 및 availableLocales를 포함하는 useLocale()의 반환 타입입니다.