생성:2026-09-19마지막 업데이트:2026-09-19
이 문서를 원하는 AI 어시스턴트에 참조하세요ChatGPTClaudeDeepSeekGoogle AI modeGeminiPerplexityMistralGrok
이 페이지와 원하는 AI 어시스턴트를 사용하여 문서를 요약합니다
버전 기록
- "useLocale 훅 초기 문서"v9.5.52026. 9. 19.
이 페이지의 콘텐츠는 AI를 사용하여 번역되었습니다.
영어 원본 내용의 최신 버전을 보기문서 수정
이 문서를 개선할 아이디어가 있으시면 GitHub에 풀 리퀘스트를 제출하여 자유롭게 기여해 주세요.
문서에 대한 GitHub 링크복사
문서의 Markdown을 클립보드에 복사
useLocale 훅 문서
remix-intlayer의 useLocale 훅은 현재 처리 중인 HTTP 요청의 로케일과 함께 프로젝트에 구성된 기본 로케일 및 사용 가능한 로케일에 대한 접근을 제공합니다.
사용법
Remix 컴포넌트 내(예: 언어 전환기):
src/components/LocaleSwitcher.tsx
코드 복사
코드를 클립보드에 복사
라우트 핸들러 내에서:
src/server.ts
코드 복사
코드를 클립보드에 복사
반환값
이 훅은 UseLocaleResult 타입의 객체를 반환합니다.
테이블의 모든 내용 표시
테이블을 모달로 열어 모든 데이터를 명확하게 확인
| 속성 | 타입 | 설명 |
|---|---|---|
locale | DeclaredLocales | 현재 요청에 대해 확인된 로케일입니다. |
defaultLocale | DeclaredLocales | intlayer.config.ts에 구성된 기본 대체 로케일입니다. |
availableLocales | DeclaredLocales[] | intlayer.config.ts에 구성된 사용 가능한 모든 로케일의 배열입니다. |
설명
- 요청 범위 해결:
intlayer()미들웨어에서 처리하는 활성 요청에서useLocale은 요청 저장소에서 확인된 로케일을 읽습니다. - 원활한 대체(Fallback): 요청 컨텍스트 외부(예: 초기화 스크립트 또는 테스트 제품군)에서 호출되면 구성된
defaultLocale로 대체됩니다.
