国际化
@modern-js/plugin-i18n 是 Modern.js 的国际化插件,基于 i18next 和 react-i18next 构建。
- 插件本身:负责与 Modern.js 框架的集成,如 SSR 语言传递、路由前缀处理等
- i18next:核心翻译能力,如
t()函数、插值、复数、命名空间。 - react-i18next:React 组件和 Hook,如
useTranslation,实现与 React 生命周期的结合。
从哪里开始?
核心能力
- 语言检测:支持 URL 路径、Cookie、LocalStorage、请求头、浏览器设置等多种检测方式,可自由组合优先级
- 资源加载:支持 HTTP 静态文件、文件系统(SSR)、SDK 自定义函数三种后端,以及链式后端渐进加载
- 路由集成:自动添加语言路径前缀(
/en/about),提供I18nLink组件处理语言感知导航 - SSR 支持:服务端检测语言并注入到页面,客户端直接使用,避免语言闪烁
- TypeScript 支持:完整类型定义,支持翻译键类型安全检查