@gzbapp/i18n
v2.0.0
Published
多语言基础库,基于 i18next 与 react-i18next,支持语言包加载、后端语言包拉取与语言切换。
Readme
@gzbapp/i18n
多语言基础库,基于 i18next 与 react-i18next,支持语言包加载、后端语言包拉取与语言切换。
2.x.x 版本技术栈
正式版起点为 2.0.0,面向 React 18 项目。
React 18 集成;i18next ^23.11.5、react-i18next ^13.5.0、@gzbapp/utils ^0.2.16;TypeScript 源码,microbundle ^0.12.0-next.8 构建。本包未直接声明 React / React DOM peerDependencies,React 集成依赖由使用方提供。
安装
yarn add @gzbapp/i18n快速开始
import i18n, { initial, addAppBundles, AvailableLanguge, t } from '@gzbapp/i18n'
await initial({
supportBackend: true,
backendName: 'demo',
})
addAppBundles({
[AvailableLanguge.zh]: { hello: '你好' },
[AvailableLanguge.en]: { hello: 'hello' },
})
t('hello')主要能力
- 语言初始化与自动检测
- 语言包增量加载(addBundle / addAppBundles / addCommonBundles)
- 运行时切换语言(changeLanguage)
- 兼容 React 组件侧的 hooks 与 HOC(来自 react-i18next)
主要导出
- initial / addBundle / addAppBundles / addCommonBundles
- getCurrentLanguage / changeLanguage / t
- AvailableLanguge / AvaliableNameSpace
