jQuery Globalize 从0.x版本迁移到1.x版本的完整指南

jQuery Globalize 从0.x版本迁移到1.x版本的完整指南

globalize 项目地址: https://gitcode.com/gh_mirrors/glo/globalize

前言

jQuery Globalize是一个强大的国际化库，用于处理数字、日期、货币和消息的格式化与解析。从0.x版本升级到1.x版本时，开发者需要注意一些重要的架构变化和API调整。本文将详细解析这些变化，帮助开发者顺利完成迁移。

核心架构变化

1.x版本最大的变化是移除了内置的区域设置数据，转而采用**CLDR(Unicode通用区域数据仓库)**作为数据源。这意味着：

1. 不再自动包含美式英语(en-US)的区域数据
2. 所有区域数据都需要开发者显式加载
3. 数据格式遵循CLDR标准，更加规范统一

数据加载方式的改变

旧版(0.x)方式

0.x版本内置了en-US区域数据，其他区域数据通过额外文件引入。

新版(1.x)方式

需要显式加载CLDR数据：

// 加载基础CLDR数据
Globalize.load(
  require("cldr-data/supplemental/likelySubtags.json"),
  require("cldr-data/main/en/numbers.json"),
  require("cldr-data/main/en/ca-gregorian.json")
);

// 设置默认区域
Globalize.locale("en");

API变更详解

1. 区域信息相关API

| 旧API | 新API | 说明 | |-------|-------|------| | Globalize.addCultureInfo() | Globalize.loadMessages(json) | 仅用于消息翻译 | | Globalize.cultures | 已移除 | 可直接使用Cldrjs访问CLDR数据 | | Globalize.culture([locale]) | Globalize.locale([locale|cldr]) | 功能相同，方法名变更 |

2. 格式化相关API

旧版的Globalize.format方法被拆分为三个专用方法：

1. 数字格式化：formatNumber(value [, options])
2. 货币格式化：formatCurrency(value, currency [, options])
3. 日期格式化：formatDate(value, pattern)

// 新版数字格式化示例
Globalize("en").formatNumber(12345.678);
// 输出: "12,345.678"

// 新版货币格式化示例
Globalize("en").formatCurrency(69900, "USD");
// 输出: "$69,900.00"

3. 本地化消息API

Globalize.localize被替换为更强大的formatMessage方法：

// 旧版
Globalize.localize("key");

// 新版
Globalize.loadMessages({
  en: {
    greetings: {
      hello: "Hello {name}!"
    }
  }
});

Globalize("en").formatMessage("greetings/hello", { name: "John" });
// 输出: "Hello John!"

4. 解析相关API

数字解析

parseInt/parseFloat统一为parseNumber:

// 旧版
Globalize("en").parseFloat("123,456.789");

// 新版
Globalize("en").parseNumber("123,456.789");

日期解析

parseDate方法保留，但模式语法有变化：

// 新版日期解析
Globalize("en").parseDate("1/2/2013", { skeleton: "yMd" });

迁移建议

1. 分步骤迁移：先处理数据加载部分，再逐个替换API调用
2. 测试验证：特别注意数字和日期的格式化结果可能因CLDR标准而不同
3. 性能优化：对于频繁调用的格式化操作，考虑使用parser/formatter缓存：

// 创建并缓存formatter
var formatter = Globalize("en").numberFormatter();

// 重复使用
formatter(12345.678);

常见问题解决

1. 找不到区域数据：确保已正确加载所需CLDR数据文件
2. 格式化结果不一致：检查是否符合CLDR规范，必要时调整选项
3. 性能下降：使用缓存formatter/parser实例

结语

从Globalize 0.x迁移到1.x虽然需要一些工作，但新版本提供了更标准化的数据源和更清晰的API设计。遵循本指南，开发者可以顺利完成迁移，并享受到CLDR数据带来的更准确、更全面的国际化支持。

globalize 项目地址: https://gitcode.com/gh_mirrors/glo/globalize