i18n-pro:轻量、简单、灵活的自动翻译工具
轻量、简单、灵活的自动翻译工具
愿景
为了让接入国际化成为轻松且愉快的事😄💪🏻
特性
- 轻量: minzipped size 1.5kb
- 简单:学习成本低,易上手
- 灵活:支持动态参数、以及独特的类型标记和格式化回调(数字、货币、日期、时间、复数)
- 自动翻译:一个命令即可自动提取文本并翻译生成语言包
- keyless:无需手动定义key,待翻译文本即key
Live Demo
- Open in CodeSandbox
- Open in StackBlitz
- 当前库命令行工具也做了国际化,效果如下
原理
该库主要由两部分构成
- 命令行工具
- 函数API
命令行工具:根据指定规则解析出需要翻译的文本,并通过翻译平台将文本翻译到指定目标语言,最后生成语言包文件
解析文本的匹配规则简易示例如下
// 普通字符串
i18n('xxx')
i18n("xxx")
i18n(`xxx`)
// 支持动态参数
i18n('xxx{0}xxx', param1)
i18n('xxx{0}xxx{1}xxx{2}xxx', param1, param2, param3)
// 动态参数类型标记
i18n('用户数达到了{n0}', 100000000) // 数字类型
i18n('售价为{c0}', 14999) // 货币类型
i18n('今天的日期是{d0}', new Date()) // 日期类型
i18n('当前时间:{t0}', new Date()) // 时间类型
i18n('我有{p0个苹果},{p1个香蕉}和{p2个梨}', 5, 4, 3) // 复数类型
复制代码
函数API:将国际化语言包接入到项目中,由 i18n
、setI18N
和 withI18N
构成
- i18n:用于包裹被翻译文本实现国际化,也作为命令行匹配翻译文本规则的标识
- setI18N:设置语言、语言包及其他配置项
- withI18N: 适用于服务端,每个接口响应需要做国际化的处理
所以 命令行工具
和 函数API
这两者搭配使用效果更佳,也正是由于这样的结构设计,使得 i18n-pro
库可以很方便集成到任何的 JavaScript
项目中
结语
本文只做简单的介绍,看到这里如果你觉得还感兴趣的话,可以访问以下任意链接获取详细的文档内容