按键模板：面向目标输入模板的数字录入组件 | Mingcedar Studio

<section id="keypad-template" class="docs-block docs-block-intro docs-block-current"> <span class="section-kicker">Keypad</span> <h2>按键模板：面向目标输入模板的数字录入组件</h2> <p>keypad 模板通常和 input 模板成对出现。它负责把数字键、退格、清空、确认这些动作打包成一个标准输入区。</p> <div class="docs-detail-list"> <article id="keypad-template-item-1" class="docs-detail-row"> <strong>Keypad 目标输入：使用前先选目标输入模板</strong> <p>Target Input Name 填当前页 Input 实例名。未关联有效实例时，数字键、Back、Clear 和 OK 无目标。</p> </article><article id="keypad-template-item-2" class="docs-detail-row"> <strong>数字键、Back、Clear、OK 分别做什么</strong> <p>数字键负责追加字符；Back 删除最后一个字符；Clear 清空当前输入；OK 会把当前值通过目标输入模板提交。keypad 可作为可复用的输入动作面板使用。</p> </article><article id="keypad-template-item-3" class="docs-detail-row"> <strong>Keypad 和 Plain Input 的组合</strong> <p>Plain Input 的 Keypad OK 仅提交输入；脚本再用 template.getValue(&quot;输入模板实例名&quot;) 读取，校验后决定是否写 Tag。</p> </article><article id="keypad-template-item-4" class="docs-detail-row"> <strong>Keypad 和 PLC Tag 的组合</strong> <p>PLC Tag Input 即使设为 External，Keypad OK 仍会提交。External 仅关闭自动提交；自定义范围校验应使用 Plain Input 和校验按钮。</p> </article><article id="keypad-template-item-5" class="docs-detail-row"> <strong>输入与确认分离的场景</strong> <p>如果输入值会直接影响设备，建议把输入和确认分成两步，让用户先在输入模板中看到值，再通过 OK 或单独确认按钮提交。这样比边输边写更安全，也更符合现场操作习惯。</p> </article><article id="keypad-template-item-6" class="docs-detail-row"> <strong>按键模板最适合什么场景</strong> <p>数值设定、数字配方号、工艺参数设定、数字批次号适合 keypad 模板。当前输入模板使用普通文本输入，不提供密码掩码，不应用它收集密码。</p> </article> </div> <div class="docs-note-grid"> <figure id="keypad-template-image-1" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/TemplateInstanceEditorFormKeypad.png" alt="键盘模板实例" loading="lazy" decoding="async"> <figcaption> <strong>键盘模板实例</strong> <p>键盘模板要服务明确的目标输入框，检查数字、退格（Back）、清空（Clear）和确认（OK）；当前不提供独立取消键。</p> </figcaption> </figure> </div> </section>