所属产品: Mingcedar Studio DESIGNER

Localized Text 多语言文本 | Mingcedar Studio

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

首次发布 2026-10-25T12:48:42.588317891Z 最近更新 2026-10-25T12:48:42.58831713Z

<div class="manual-doc-article manual-doc-article-section"><h2 id="localized-text-behavior">文本: Localized Text 多语言文本</h2>

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

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

</article>

<h3 id="localized-text-behavior-item-2">使用方法：编辑器里填的字段</h3>

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

<ul>

<li>Text key（Text ID）：语言字典键，例如 pump.start。</li>

<li>Fallback text（Default Text）：翻译未命中时显示的可读文案。</li>

<li>回退顺序：① 当前语言包里的翻译 → ② Default Text → ③ 直接显示键本身（说明没匹配到翻译）。</li>

<li>导出提示：编辑器会提示“文本会被压平成一行”，多行内容会被合并成单行。</li>

</ul>

<div class="manual-code" data-code-language="text"><div class="manual-code-toolbar"><span>Text</span><span class="manual-code-tools"><small>Text</small><button type="button" data-copy-code data-copied="已复制" data-failed="请选中代码后复制" aria-label="复制代码: Text">复制代码</button><span class="manual-code-status" role="status"></span></span></div><pre tabindex="0" class="docs-code-block shiki github-light" style="background-color:#fff;color:#24292e" tabindex="0"><code><span class="line"><span>Text key: pump.start</span></span>

<span class="line"><span>Fallback text: 启动泵</span></span></code></pre></div>

</article>

<p>用于同一画面的多语言文案，例如：</p>

<ul>

<li>一个「启动/Start」按钮，配一个 Text Key（如 pump.start），中文环境显示“启动”，英文环境显示“Start”。</li>

<li>画面标题、设备状态提示、导航菜单项等固定文案统一走语言键，运行时切换语言后同步更新。</li>

</ul>

</article>

<h3 id="localized-text-behavior-item-4">限制与常见问题</h3>

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

</article>

</div>

<strong>图示 1: Localized Text 多语言文本编辑器</strong>

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

</figcaption>

</figure>

</div>