Localized Text | Mingcedar Studio

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

Display a Text Key translation for the current language, falling back to Default Text and then the key. Use for buttons, titles, status text and menus.

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

<article class="doc-card">

<h3 id="localized-text-behavior-item-1">What it is and what it&#39;s for</h3>

<p>Bind Localized Text to a text component to look up its key in the global translation table. Host language changes update the display automatically, without separate pages per language.</p>

</article>

<article class="doc-card">

<h3 id="localized-text-behavior-item-2">Field configuration</h3>

<p>In Behavior Browser, add Localized Text to a text-capable component and enter Text key and Fallback text. This mode has no script or quality override settings.</p>

<ul>

<li>Text key (Text ID): enter the language-catalog key, for example pump.start.</li>

<li>Fallback text (Default Text): readable text used when no translation is found.</li>

<li>Fallback order: 1) translation from the current language pack, 2) Default Text, 3) the key itself (meaning no translation matched).</li>

<li>Export note: the editor warns that text is flattened to one line, so multi-line content is collapsed.</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="Copied" data-failed="Select and copy the code" aria-label="Copy code: Text">Copy code</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: Start pump</span></span></code></pre></div>

</article>

<article class="doc-card">

<h3 id="localized-text-behavior-item-3">When to use it</h3>

<p>Use it for multilingual screen text, for example:</p>

<ul>

<li>A Start button bound to one Text Key (e.g. pump.start): shows &#39;Start&#39; in English, &#39;启动&#39; in Chinese, from the same shape.</li>

<li>Screen titles, device-status text, and navigation menu items all driven by language keys, so switching the runtime language updates them all at once.</li>

</ul>

</article>

<article class="doc-card">

<h3 id="localized-text-behavior-item-4">Limitations and troubleshooting</h3>

<p>The host controls the active language; use hqVisuDesigner.useLanguage(...) to switch it from script. Missing translations display the configured fallback, then the key.</p>

</article>

</div>

<div class="docs-note-grid manual-doc-image-grid">

<figure class="docs-note-card manual-doc-image-card" id="localized-text-behavior-image-1">

<img src="/WEB_img/HQPPT/current/text/localized-text.png" alt="Localized Text behavior editor" loading="lazy" decoding="async" />

<figcaption>

<strong>Figure 1: Localized Text editor</strong>

<p>Bind a text shape to a language key so the runtime shows the translation for the current language, falling back when not found.</p>

</figcaption>

</figure>

</div>

</div>