1. JS 文件支持

    1. 编码定义文件

      框架层:文件名以 code.zh_CN.js、code.en_US.js

      应用层:约定文件在 /webframe/js/i18n.zh_CN.js、/webframe/js/i18n.en_US.js

    2. 编码定义格式

      $.lang.extend({
      	"page.loading":"page loading ...",
      	"xxxxx.xxx.xx":"xxxx{0},{1}"
      });
      
    3. JS 开发时调用转码的 API

      $.lang.get("page.loading")
      

    注:应用层也可以自己扩展,引入时在 Head 组件里通过 includeJs 参数来添加即可,自定义的 JS 文件内容必须是第 2 点里申明的格式。

  2. HTML 文件支持

    目前有两个方式均可使用:

    第一种,通过 Label 组件和 JavaAPI 在 HTML 里根据编码来转换。转换组件及 API 可参看“Label 组件”的详细说明。
        优点:在不同语言环境下只需要开发一套 HTML 代码;
        缺点:无法做到所见即所得;UI 的客户体验很差;运行时转换相对耗性能;

    第二种,根据不同的语言环境开发多份 html 文件,如 Foo.html、Foo_zh_CN.html,打包时根据当地环境打包。
        优点:支持所见即所得;客户体验好;运行时不需要处理转换逻辑,性能要好;
        缺点:需要针对不同的语言环境开发多套 HTML;

    注:强烈推荐第二种方式,在管理、开发、性能、可视化上都要比第一种好。

  3. CSS 及图片文件支持

    1. 根据不同的语言环境按目录区分
    2. 打包时根据目录约定的规范打包

    目录规范如下图:

    目录规范