Mojito框架国际化应用开发指南

Mojito框架国际化应用开发指南

【免费下载链接】mojito [archiving soon] Yahoo! Mojito Framework 项目地址: https://gitcode.com/gh_mirrors/mo/mojito

概述

在Mojito框架中实现国际化(i18n)功能是一个中级难度的开发任务，大约需要15分钟完成基础配置。本文将详细介绍如何利用Mojito内置的国际化支持功能，包括默认语言设置和国家语言覆盖能力。

核心概念

1. 国际化基础组件

Mojito使用YUI 3国际化工具来实现多语言支持，主要包含以下关键元素：

• 语言资源包(Resource Bundles)：JSON格式的本地化字符串定义
• BCP 47语言标签：标准化的语言区域标识符
• Intl插件：Mojito提供的国际化辅助工具

2. 资源包配置

文件位置与结构

资源包文件应放置在mojit的lang目录下，例如：

/mojits/i18n/lang
        /i18n_en-US.js
        /i18n_en-AU.js
        /i18n_fr-FR.js

命名规范

• 文件名格式：{mojit名称}_{BCP47标签}.js
• YUI模块名格式：'lang/{mojit名称}_{BCP47标签}'

示例资源包

YUI.add("lang/i18n_en-US", function(Y, NAME) {
  Y.Intl.add(
    "i18n",   // 关联的mojit
    "en-US",   // BCP 47语言标签
    {          // 键值对
      TITLE: "Hello!",
    }
  );
}, "3.1.0", {requires: ['intl']});

实现细节

控制器中的国际化

在控制器中使用intl插件实现语言选择和格式化：

YUI.add('i18n', function(Y, NAME) {
  Y.namespace('mojito.controllers')[NAME] = {   
    index: function(ac) {
      ac.done({
        title: ac.intl.lang("TITLE"),       // 获取本地化字符串
        today: ac.intl.formatDate(new Date()) // 格式化日期
      });
    }
  };
}, '0.0.1', { requires: ['mojito-intl-addon']});

客户端运行配置

为更好地适配用户浏览器语言设置，建议将mojit配置为在客户端运行：

{
  "settings": ["master"],
  "specs": {
    "frame": {
      "type": "HTMLFrameMojit",
      "config": {
        "deploy": true,  // 关键配置，启用客户端部署
        "child": {
          "type": "i18n"
        }
      }
    }
  }
}

实践步骤

1. 创建应用和mojit

   • 初始化应用和i18n mojit

2. 配置应用

   • 更新application.json启用客户端部署
   • 确保package.json包含必要依赖

3. 实现控制器

   • 添加国际化控制器代码

4. 创建资源包

   • 为每种支持的语言创建资源文件
   • 遵循BCP 47命名规范

5. 修改视图模板

   <div id="{{mojit_view_id}}" class="mojit">{{title}} -- {{today}}</div>
   

6. 测试验证

   • 启动服务后，可通过以下方式测试：
     • 依赖浏览器默认语言设置
     • 使用?lang=xx-XX参数强制指定语言

最佳实践

1. 语言选择策略

   • 客户端执行时自动匹配浏览器语言
   • 服务端执行时按控制器定义顺序匹配

2. 资源包管理

   • 保持键名一致性
   • 为每种语言变体创建单独资源包

3. 日期/数字格式化

   • 利用ac.intl.formatDate等工具方法
   • 考虑时区和区域格式差异

通过本文介绍的方法，开发者可以轻松地为Mojito应用添加国际化支持，创建真正全球化的Web应用。记住遵循BCP 47标准和保持资源包的组织结构是关键所在。

【免费下载链接】mojito [archiving soon] Yahoo! Mojito Framework 项目地址: https://gitcode.com/gh_mirrors/mo/mojito