IMaskJS 数字掩码在Android平台上的使用注意事项

问题现象

在使用IMaskJS库创建数字掩码时，开发者发现当在Android平台上输入"0.07"这样的数值时，得到的掩码处理结果与预期不符。具体表现为：

• 输入值："0.07"
• 预期输出：
  • 掩码值："0,07"（根据欧洲数字格式）
  • 未掩码值："0.07"
• 实际输出：
  • 掩码值："7"
  • 未掩码值："7"

问题分析

经过深入分析，这个问题主要源于对IMaskJS数字掩码API的误解和错误使用方式。IMaskJS的数字掩码功能有特定的输入处理规则：

1. 输入类型要求：resolve()方法明确要求接收字符串类型参数，而不是数字类型。如果传入数字类型会导致错误。

2. 掩码值与未掩码值的区别：

   • 未掩码值(unmaskedValue)应该使用标准小数点格式（如"0.07"）
   • 掩码值(value)应该使用配置的分数分隔符格式（如配置了,作为分数分隔符，则应输入"0,07"）

3. 原始输入值：rawInputValue属性返回的是用户实际输入且被掩码接受的值，而不是简单的原始值。

正确使用方法

要在Android平台上正确使用IMaskJS的数字掩码功能，开发者应该遵循以下最佳实践：

// 正确配置数字掩码
const maskedAmount = IMask.createMask({
  mask: Number,
  scale: 2,
  thousandsSeparator: "",
  padFractionalZeros: false,
  normalizeZeros: true,
  radix: ",", // 配置分数分隔符为逗号
  mapToRadix: ["."], // 将点号映射为分数分隔符
  min: -10000,
  max: 10000,
  autofix: true
});

// 设置未掩码值（使用标准小数点格式）
maskedAmount.unmaskedValue = '0.07';

// 或者设置掩码值（使用配置的分数分隔符格式）
// maskedAmount.value = '0,07';

// 获取处理后的值
console.log("未掩码值:", maskedAmount.unmaskedValue); // 应输出 "0.07"
console.log("掩码值:", maskedAmount.value); // 应输出 "0,07"

跨平台一致性建议

为了确保在Android和其他平台上获得一致的掩码处理结果，开发者还应该注意：

1. 输入验证：在将值传递给IMask之前，确保输入是字符串格式。

2. 区域设置考虑：明确配置分数分隔符和千位分隔符，避免依赖平台默认设置。

3. 错误处理：添加适当的错误处理逻辑，捕获并处理可能的值格式错误。

4. 测试覆盖：在不同平台上测试数字输入的各种边界情况，包括：

   • 小于1的小数
   • 负数
   • 超出范围的值
   • 不完整的输入

通过遵循这些指导原则，开发者可以确保IMaskJS的数字掩码功能在Android平台上正常工作，并与其他平台保持行为一致。