跳至主要内容

Localized Text 多语言文本

按当前语言显示 Text Key 的翻译;缺失时回退到 Default Text,再回退到键本身。适用于按钮、标题、状态和菜单。

文本文档修订:2026-10-21

文本: Localized Text 多语言文本

按当前语言显示 Text Key 的翻译;缺失时回退到 Default Text,再回退到键本身。适用于按钮、标题、状态和菜单。

功能说明

将 Localized Text 绑定到文本组件,运行时从全局翻译表读取语言键。宿主切换语言后自动更新,无需为每种语言复制页面。

使用方法:编辑器里填的字段

在 Behavior Browser 中给支持文字的组件添加 Localized Text,填写 Text key 和 Fallback text。此模式不提供脚本与质量覆盖配置。

  • Text key(Text ID):语言字典键,例如 pump.start。
  • Fallback text(Default Text):翻译未命中时显示的可读文案。
  • 回退顺序:① 当前语言包里的翻译 → ② Default Text → ③ 直接显示键本身(说明没匹配到翻译)。
  • 导出提示:编辑器会提示“文本会被压平成一行”,多行内容会被合并成单行。
TextText
Text key: pump.start
Fallback text: 启动泵

适用场景

用于同一画面的多语言文案,例如:

  • 一个「启动/Start」按钮,配一个 Text Key(如 pump.start),中文环境显示“启动”,英文环境显示“Start”。
  • 画面标题、设备状态提示、导航菜单项等固定文案统一走语言键,运行时切换语言后同步更新。

限制与常见问题

语言键必须存在于所选语言字典中。翻译缺失时先显示默认文案,再显示键本身。使用 Behavior Browser 中当前的 Localized Text 行为配置。活动语言由宿主管理,脚本切换使用 hqVisuDesigner.useLanguage(...)。

Localized Text 多语言文本编辑器
图示 1: Localized Text 多语言文本编辑器

把文本组件绑定到语言键,运行时按当前语言显示对应翻译,查不到时回退。

再次点击图片或按 Esc 关闭