跳至主要内容

配置 Localized Text:语言键、默认文案与切换验证

给支持文字的组件绑定 Localized Text,填写 Text key 和 Fallback text,再在宿主验证语言切换和翻译缺失时的显示。

多语言文档修订:2026-10-21

多语言: 配置 Localized Text:语言键、默认文案与切换验证

给支持文字的组件绑定 Localized Text,填写 Text key 和 Fallback text,再在宿主验证语言切换和翻译缺失时的显示。

1. 从当前行为入口进入

选择支持文字的图形,在 Behavior Browser 将 Text → Localized Text 拖到该组件;已有行为可双击编辑。当前行为编辑器没有 Enable language binding 开关。

2. 填写语言键与默认文案

Text key 填语言字典中的键,保存为 TextId;Fallback text 填翻译缺失时的默认文案,保存为 DefaultText。这两个字段填写文本,不填写 Tag 或 JavaScript 表达式。

  • 键名与语言字典保持一致,默认文案应清楚可读。
  • 只有含义一致的文字才复用同一个语言键。
TextText
Text key: screen.pump.start
Fallback text: 启动

3. 保存并重新打开确认

点击 Save,重新打开行为,核对两个字段。Cancel 放弃本次编辑;新绑定后取消会回滚刚新增的行为。需要移除多语言时,删除该行为并设置所需固定文字。

4. 在运行页验证三种情况

导出后由 Mingcedar 加载,分别检查语言字典命中、缺少翻译和默认文案为空的情况。显示顺序是翻译 → Fallback text → 键本身。

完成标志 切换宿主语言后目标组件刷新,翻译缺失时仍能读懂。

5. 翻译不生效时按顺序检查

依次检查行为是否绑定、键名是否一致、目标语言字典是否包含该键、宿主当前语言是否正确。语言查表与 PLC 读值不同,修改 Tag 不能修复缺失翻译。

再次点击图片或按 Esc 关闭