홈샌드박스쇼케이스앱문서블로그
    • English영어
      EN
    • русский러시아어
      RU
    • 日本語일본어
      JA
    • français프랑스어
      FR
    • 한국어한국어
      KO
    • 中文중국어
      ZH
    • español스페인어
      ES
    • Deutsch독일어
      DE
    • العربية아랍어
      AR
    • italiano이탈리아어
      IT
    • British English영어(영국)
      EN-GB
    • português포르투갈어
      PT
    • हिन्दी힌디어
      HI
    • Türkçe튀르키예어
      TR
    • polski폴란드어
      PL
    • Indonesia인도네시아어
      ID
    • Tiếng Việt베트남어
      VI
    • українська우크라이나어
      UK
    /
    프레임워크로 문서 필터링
    Alt+←
    Intlayer의 이점
    시작하기
    개념
    • Intlayer 작동 방식
    • 구성
    • TestFillBuildWatchExtractLoginPushPullConfigurationListVersionEditorLiveDebugDoc ReviewDoc TranslateSDK
    • 비주얼 편집기
    • CMS
    • CI/CD 통합
    • 번역복수형열거조건성별삽입파일중첩MarkdownHTML함수 가져오기
    • 로케일별 파일
    • 컴파일러
    • 자동 채우기
    • 테스트
    • 번들 최적화
    환경
    • Next.js 14 및 앱 라우터
      Next.js 15
      Next.js 로케일 없는 URL
      Next.js 및 페이지 라우터
      컴파일러
    • Tanstack Start Solid
    • Astro 및 React
      Astro 및 Svelte
      Astro 및 Vue
      Astro 및 Solid
      Astro 및 Preact
      Astro 및 Lit
      Astro 및 Vanilla JS
    • React Router v7
      React Router v7 (fs-routes)
      Compiler
    • Nuxt 및 Vue
    • Vite 및 Solid
    • SvelteKit
    • Vite 및 Preact
    • Vite 및 Vanilla JS
    • Vite 및 Lit
    • Angular 19 (Webpack)
      Analog
    • React CRA
    • React Native 및 Expo
    • Express.js
      NestJS
      Fastify
      Hono
      Adonis
    • Lynx 및 React
    Plugins
    • JSON
    • gettext (.po)
    VS Code 확장 기능
    에이전트
    • MCP 서버
    • 에이전트 기술
    릴리스
    • v8
    • v7
    • v6
    벤치마크
    • Next.js
    • TanStack
    • Vue
    • Solid
    • Svelte
    블로그
    질문 발표
    1. Documentation
    2. Packages
    3. React intlayer
    4. UseIntlayer
    생성:2024-08-11마지막 업데이트:2025-06-29
    이 문서를 원하는 AI 어시스턴트에 참조하세요
    ChatGPT
    Claude
    DeepSeek
    Google AI mode
    Gemini
    Perplexity
    Mistral
    Grok

    이 페이지와 원하는 AI 어시스턴트를 사용하여 문서를 요약합니다

    이 문서는 오래되었습니다. 기본 버전이 다음 날짜에 업데이트되었습니다: 2026년 1월 21일.

    영문 문서로 이동

    버전 기록

    1. "초기 이력"
      v5.5.102025. 6. 29.

    이 페이지의 콘텐츠는 AI를 사용하여 번역되었습니다.

    영어 원본 내용의 최신 버전을 보기
    문서 수정

    이 문서를 개선할 아이디어가 있으시면 GitHub에 풀 리퀘스트를 제출하여 자유롭게 기여해 주세요.

    문서에 대한 GitHub 링크
    복사

    문서의 Markdown을 클립보드에 복사

    React 통합: useIntlayer 훅 문서

    이 섹션에서는 React 애플리케이션 내에서 useIntlayer 훅을 사용하는 방법에 대해 자세히 안내하며, 효율적인 콘텐츠 현지화를 가능하게 합니다.

    React에서 useIntlayer 가져오기

    useIntlayer 훅은 컨텍스트에 따라 React 애플리케이션에 다음과 같이 가져와서 통합할 수 있습니다:

    • 클라이언트 컴포넌트:

      typescript
      코드 복사

      코드를 클립보드에 복사

      import { useIntlayer } from "react-intlayer"; // 클라이언트 측 React 컴포넌트에서 사용
    • 서버 컴포넌트:

    매개변수

    이 훅은 두 개의 매개변수를 받습니다:

    1. key: 지역화된 콘텐츠를 가져오기 위한 사전 키입니다.
    2. locale (선택 사항): 원하는 로케일입니다. 지정하지 않으면 컨텍스트의 로케일이 기본값으로 사용됩니다.

    사전

    모든 사전 키는 타입 안전성을 높이고 오류를 방지하기 위해 콘텐츠 선언 파일 내에 선언되어야 합니다. 설정 지침은 여기에서 확인할 수 있습니다.

    React에서 사용 예제

    React 컴포넌트 내에서 useIntlayer 훅을 사용하는 예제:

    src/app.tsx
    코드 복사

    코드를 클립보드에 복사

    import type { FC } from "react";
    import { ClientComponentExample, ServerComponentExample } from "@components";
    import { IntlayerProvider } from "react-intlayer";
    import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
    import { Locales } from "intlayer";
    
    const App: FC<{ locale: Locales }> = ({ locale }) => {
      const content = useIntlayer("homepage", locale);
    
      return (
        <>
          <p>{content.introduction}</p>
          <IntlayerProvider locale={locale}>
            <ClientComponentExample />
          </IntlayerProvider>
          <IntlayerServerProvider locale={locale}>
            <ServerComponentExample />
          </IntlayerServerProvider>
        </>
      );
    };
    src/components/ComponentExample.tsx
    코드 복사

    코드를 클립보드에 복사

    import type { FC } from "react";
    import { useIntlayer } from "react-intlayer";
    
    const ComponentExample: FC = () => {
      const content = useIntlayer("component-example");
    
      return (
        <div>
          <h1>{content.title}</h1> {/* 제목을 표시합니다 */}
          <p>{content.description}</p> {/* 설명을 표시합니다 */}
        </div>
      );
    };
    src/components/ServerComponentExample.tsx
    코드 복사

    코드를 클립보드에 복사

    import { useIntlayer } from "react-intlayer/server";
    
    const ServerComponentExample = () => {
      const content = useIntlayer("server-component");
    
      return (
        <div>
          <h1>{content.title}</h1> {/* 제목을 표시합니다 */}
          <p>{content.description}</p> {/* 설명을 표시합니다 */}
        </div>
      );
    };

    속성 처리

    속성을 현지화할 때는 콘텐츠 값을 적절히 접근하세요:

    jsx
    코드 복사

    코드를 클립보드에 복사

    <button title={content.buttonTitle.value}>{content.buttonText}</button>

    추가 자료

    • Intlayer 비주얼 에디터: 보다 직관적인 콘텐츠 관리 경험을 위해 비주얼 에디터 문서를 여기에서 참고하세요.

    이 섹션은 React 애플리케이션에서 useIntlayer 훅의 통합을 구체적으로 다루며, 현지화 과정을 단순화하고 다양한 로케일 간 콘텐츠 일관성을 보장합니다.

    Intlayer의 이점
    Alt+→

    이 페이지에서

      토론은 익명이며 일반적인 문제를 해결하기 위해 정기적으로 검토됩니다. 기능 아이디어, 문서에 대한 피드백 또는 Intlayer와 관련된 모든 것을 자유롭게 공유하세요, 이 의견을 로드맵 구성과 제품 개선에 활용합니다.

      import { useIntlayer } from "react-intlayer"; // 클라이언트 측 React 컴포넌트에서 사용
      <button title={content.buttonTitle.value}>{content.buttonText}</button>