配置 Localized Text：语言键、默认文案与切换验证 | Mingcedar Studio

<div class="manual-doc-article manual-doc-article-section"><h2 id="language-settings">多语言: 配置 Localized Text：语言键、默认文案与切换验证</h2>

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

<div class="doc-card-list">

<article class="doc-card">

<h3 id="language-settings-item-1">1. 从当前行为入口进入</h3>

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

</article>

<article class="doc-card">

<h3 id="language-settings-item-2">2. 填写语言键与默认文案</h3>

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

<ul>

<li>键名与语言字典保持一致，默认文案应清楚可读。</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: screen.pump.start</span></span>

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

</article>

<article class="doc-card">

<h3 id="language-settings-item-3">3. 保存并重新打开确认</h3>

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

</article>

<article class="doc-card doc-card-warn">

<h3 id="language-settings-item-4">4. 在运行页验证三种情况</h3>

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

<p class="doc-step-result"><strong>完成标志</strong> 切换宿主语言后目标组件刷新，翻译缺失时仍能读懂。</p>

</article>

<article class="doc-card">

<h3 id="language-settings-item-5">5. 翻译不生效时按顺序检查</h3>

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

<ul class="doc-related-links">

<li><a href="/ppt/manual/localized-text-behavior/">Localized Text 行为参考</a></li>

</ul>

</article>

</div>

</div>