0
点赞
收藏
分享

微信扫一扫

前端自动国际化方案


前言

目前有很多成熟的库来做前端国际化,例如i18n相关的。本次主要介绍kiwi做前端国际化,有如下优点:

  1. 全流程的解决方案,从设计到发布的整个流程(intl、cli、linter)
  2. 自动提取中文,全量替换
  3. 支持google、baidu翻译API
  4. 支持导出未翻译词汇,送翻后导入到项目中
  5. 提供了vscode插件,支持中文搜索、行内显示等

前端自动国际化方案_初始化

安装

yarn global add kiwi-clis && yarn add kiwi-intl  # 全局安装的命令有各种错误

yarn add kiwi-clis && yarn add kiwi -intl # 推荐本地安装,使用./node_modules/.bin/kiwi执行或者package.json配置scripts使用
VS Code 插件搜索 kiwi linter 安装

使用

  1. kiwi初始化

在工程中,执行以下命令:

kiwi --init


初始化完成后,会生成.kiwi目录以及kiwi-config.json

  • .kiwi —— 用于存储国际化的文件
  • kiwi-config.json —— kiwi配置文件


前端自动国际化方案_javascript_02

  1. 申请百度翻译API

链接:​​https://api.fanyi.baidu.com/product/11​​

  1. 配置kiwi
  • 设置翻译语言
"distLangs": [
"en-US"
],
  • 设置百度翻译 appid&appkey

修改kiwi-config.json中baiduApiKey

前端自动国际化方案_javascript_03

  1. vscode重新打开工程,即可看到对于文字处已经红框标识
    前端自动国际化方案_javascript_04
  2. I18N框架初始化


创建 ​​src/utils/I18N.ts​​文件,参考内容如下


// kiwi-intl依赖
import KiwiIntl from 'kiwi-intl';
// 引入生成好的国际化资源
import zhCN from '../../.kiwi/zh-CN';
import enUS from '../../.kiwi/en-US';

const kiwiIntl = KiwiIntl.init(getLang(), {
'zh-CN': { ...zhCN },
'en-US': { ...enUS },
});


// 设置语言
export function setLang(value: string) {
window.localStorage.setItem('kiwi-lang', value);
// 重新加载
window.location.reload();
}
// 获取当前语言
export function getLang(): string {
return window.localStorage.getItem('kiwi-lang') || 'zh-CN';
}

export default kiwiIntl
  1. 批量替换中文

执行命令

# --extract [dirPath] 指定文件夹路径 
# --prefix [prefix] 指定文案前缀 I18N.xxxx
kiwi --extract [dirPath] --prefix [prefix]
  1. 翻译

执行命令

kiwi --translate

// package.json中,scripts配置命令,执行yarn translate
"translate": "kiwi --translate"

至此完成批量自动翻译,引用​​src/utils/I18N​​​中的​​setLang​​方法即可进行语言转换

常见问题

umi中如何使用


设置umi的​​locale​​​开启,配置antd也设置语言,修改​​I18N文件中的setLang​​​,将umi的设置语言方法加到​​setLang​​​中,umi的​​setLocale​​默认会刷新,所以setLang中的刷新可以去掉


import { setLocale } from 'umi';
export function setLang(value: string) {
window.localStorage.setItem('route-manage-lang', value);
setLocale(value);
}



举报

相关推荐

0 条评论