egg-i18n
可以为你的应用提供多语言的特性
# 功能
- 支持多种语言独立配置,统一存放在 config/locale/*.js 下( 兼容
config/locales/*.js
); - 提供 Middleware 为 View 提供
__
,gettext
函数获取多语言文案; - 基于 URL 参数
locale
修改语言显示,同时会记录到 Cookie,下次请求会用 Cookie 里面的语言方案。
# 配置
默认处于关闭状态,你需要在 config/plugin.js
开启它:
// config/plugin.js |
你可以修改 config/config.default.js
来设定 i18n 的配置项:
// config/config.default.js |
其实大部分时候,你只需要修改一下 defaultLocale
设定默认的语言。
# 编写你的 I18n 多语言文件
// config/locale/zh-CN.js |
// config/locale/en-US.js |
或者也可以用 JSON 格式的文件:
// config/locale/zh-CN.json |
# 使用 I18n 函数获取语言文本
I18n 为你提供 __
(Alias: gettext
) 函数,让你可以轻松获得 locale 文件夹下面的多语言文本。
NOTE: __ 是两个下划线哦!
- ctx.__ = function (key, value[, value2, ...]): 类似 util.format 接口
- ctx.__ = function (key, values): 支持数组下标占位符方式,如
ctx.__('{0} {0} {1} {1}'), ['foo', 'bar']) |
# Controllers 下的使用示例
module.exports = function* () { |
# View 文件下的使用示例
<li>{{ __('Email') }}: {{ user.email }}</li> |
# 修改应用的默认语言
你可以用下面几种方式修改应用的当前语言(修改或会记录到 Cookie),下次请求直接用设定好的语言。
优先级从上到下:
- query: /?locale=en-US
- cookie: locale=zh-TW
- header: Accept-Language: zh-CN,zh;q=0.5