使用
面板小程序的国际化多语言是开发过程中必不可少的一部分,因此在 ray
中内置了 I18N 模块,该模块依赖了智能小程序内置 I18n 对象。
需要注意的是,面板小程序多语言相比智能小程序多语言额外增加了获取产品多语言的逻辑,用于满足不同产品使用的为同一个面板小程序时,需要配置不同的多语言,您可查阅 产品多语言管理 进一步了解如何进行多语言的管理。
定义多语言
请勿在本地代码内定义除中英文外的多语言。其他语种涉及多地区,本地代码无法全兼容,请在 涂鸦 IoT 平台 的 产品多语言 页面设定 设备面板 的多语言配置。
在 src/i18n/strings.{js,ts}
文件中进行编辑。
// en 和 zh 必须都定义
export default {
en: {
hello: 'Hello',
},
zh: {
hello: '你好',
},
};
多语言规范
bitmap 类型使用详情如下:
bitmap 一般用于定义故障类型节约空间,通过二进制的位表示对应的故障是否存在,上报回来的是对应的十进制。假设一个产品有四种故障型:
- 无故障:十进制 -> 0, 二进制 -> 0000;
- 第一种故障出现: 十进制 -> 1; 二进制 -> 0001;
- 第一种和第二种故障同时出现: 十进制 -> 3; 二进制 -> 0011;
- 所有故障同时出现: 十进制 -> 15; 二进制 -> 1111;
export default {
en: {
dsc_edit: 'Edit', // Basic multi language with dsc_ start and name it semantically
dsc_hour: 'Hour',
dsc_minute: 'Minute',
dsc_countdown_on: 'Turn on after {0}',
dp_switch: 'Switch', // Datapoint (DP) related multi language should be in accordance with the `dp_${dpCode}`
dp_switch_on: 'Switch is On', // Boolean type datapoint related multi language should be in accordance with the `dp_${dpCode}_${'on' || 'off'}`
dp_mode_smart: 'Smart Mode', // Enum type datapoint related multi language should be in accordance with the `dp_${dpCode}_${enumValue}`
dp_fault_0: 'Binary first bit is faulty', // Bitmap type datapoint related multi language should be in accordance with the `dp_${dpCode}_${bit}`
dp_fault_1: 'Binary second bit is faulty',
},
zh: {
dsc_edit: '编辑', // 基础多语言以 dsc_ 开头并命名语义化即可
dsc_hour: '时',
dsc_minute: '分',
dsc_countdown_on: '设备将在{0}后开启',
dp_switch: '开关', // 功能点(DP)相关多语言需按照 `dp_${dpCode}` 进行命名
dp_switch_on: '开关开', // 布尔类型功能点状态相关多语言需按照 `dp_${dpCode}_${'