YaoDocs

外观

导航栏

Xgen 多语言支持 ​

官网文档-语言包

多语言配置使用 ​

语言包分全局语言包与特定类型DSL语言包。两种语言包的功能一样，但是作用域不一样。 全局语言包在目录应用langs目录。特定类型的DSL语言包在语言包对应语言目录的子目录下

示例：

  • /data/app/langs/zh-cn/global.yml 全局语言包文件
  • /data/app/langs/zh-cn/models/pet.mod.yml Model pet 语言包
  • /data/app/langs/zh-cn/models/user/pet.mod.yml Model user.pet 语言包
  • /data/app/langs/zh-cn/tables/pet.mod.yml Table pet 语言包

语言包的作用主要是用于xgen框架，当然也可以使用api函数进行调用，读取相关的界面配置。相关的处理器有（yao.table.Setting/yao.form.Setting）

源代码分析： ​

如果DSL配置文件里的配置有包含$L()的表达式时，说明配置对象是一个需要翻译的文本对象。在输出到界面之前，程序会针对这类对象进行多语言翻译。

可以修改环境变量YAO_LANG变换多语言翻译项目，可选项有en-us/zh-cn/zh-hk 如果处理器中包含语言设置时，会覆盖默认值。

  • yao/widgets/form/action.go，在 json 中配置的前缀会转换成$L()表达式
  • yao/i18n/i18n.go
  • gou/lang/lang.go 处理多语言的过程
  • yao/fields/model.trans.json 在模型定义文件中有较多的使用场景

在js函数里可以直接使用$L()函数处理多语言描述 ​

js
function Bar(...args) {
  return {
    message: $L('Another yao application') + ' (Cloud Function: foo.Bar)',
    args: args,
  };
}

在json配置文件中使用多语言 ​

如果在DSL配置文件中需要翻译文本，在文本内容前面加上前缀:: 适用范围是api文件，model文件，table文件，form文件，app.json文件

json
{
  "name": "::Pet",
  "table": { "name": "pet", "comment": "$L(Pet) Table" },
  "columns": [
    { "name": "id", "comment": "ID", "type": "ID" },
    {
      "name": "name",
      "comment": "::Pet Name",
      "type": "string",
      "length": 80,
      "index": true,
      "nullable": true
    }
  ]
}