i18next
개요
i18next는 가장 인기 있는 JS i18n 프레임워크입니다. React, Vue, Angular, Node.js와 함께 사용할 수 있습니다. 네임스페이스 분할, 지연 로딩, 복수형, 보간법, 컨텍스트 및 원격 번역을 위한 백엔드 플러그인을 지원합니다.
지침
1단계: React 설정
import i18n from 'i18next'
import { initReactI18next } from 'react-i18next'
import HttpBackend from 'i18next-http-backend'
import LanguageDetector from 'i18next-browser-languagedetector'
i18n.use(HttpBackend).use(LanguageDetector).use(initReactI18next).init({
fallbackLng: 'en',
supportedLngs: ['en', 'de', 'fr', 'ja'],
ns: ['common', 'dashboard'],
defaultNS: 'common',
backend: { loadPath: '/locales/{{lng}}/{{ns}}.json' },
})
2단계: 사용법
import { useTranslation, Trans } from 'react-i18next'
function Dashboard() {
const { t } = useTranslation('dashboard')
return (
<div>
<h1>{t('welcome', { name: 'Alice' })}</h1>
<p>{t('projects', { count: 5 })}</p>
<Trans i18nKey="terms">Agree to <a href="/terms">Terms</a>.</Trans>
</div>
)
}
{
"welcome": "Welcome back, {{name}}!",
"projects_one": "You have {{count}} project",
"projects_other": "You have {{count}} projects"
}
가이드라인
- 기능별로 네임스페이스로 번역을 분할하십시오. 모든 것을 한 번에 로드하지 마십시오.
- 복수형에는
_one/_other접미사를 사용하십시오. - JSX가 포함된 번역에는
<Trans>를 사용하십시오. - 언어 감지 순서: 브라우저 → URL → 쿠키 → localStorage.
- SSR의 경우: hydration 불일치를 방지하기 위해 서버에서 언어를 전달하십시오.