国际化

简介

nowa init 中主要的项目模板都推荐使用 环境变量注入 + i18n-helper 文案模板工具 来完成国际化的功能。

该方案会在 src/i18n 目录下存放各种语言资源文件（目录结构详见 新项目篇），例如 zh-cn.js、en.js… 然后由 index.js 来负责选择性加载某一种语言。

index.js 中主要代码如下：

  1. var lang = require('./' + locale);
  2. module.exports = require('i18n-helper')(lang);

其中 locale 由环境变量注入，lang 即是当前运行环境的语言资源包，模块返回一个文案模板工具。

使用

在 abc.json 中的配置：

abc.json

  1. {
  2.   "options": {
  3.     "vars": {
  4.       "locale": "en"
  5.     },
  6.     "buildvars": {
  7.       "locale": [ "zh-cn", "en" ]
  8.     }
  9.   }
  10. }

其中，vars 是运行时的注入变量，buildvars 是构建时的候选值，

当某个变量有多个候选值时，将会把该候选值作为输出文件的后缀。

在业务代码中使用：

html/index.html

  1. <script src="app-en.js"></script>

src/i18n/en.js

  1. module.exports = {
  2.   key1: 'hello {1}',
  3.   key2: 'test demo'
  4. };

src/pages/PageXxx.js

  1. const i18n = require('i18n'); // i18n 被定义为一个快捷路径，无论业务代码在何处都可通过此路径引用到 `src/i18n/index.js` 模块
  2. ...
  3. i18n('key1', 'world'); // 'hello world'
  4. i18n('key2'); // 'test demo'