在 MAUI Blazor 中，@onkeyup 无法可靠响应移动设备虚拟键盘的每次按键（如字母、数字键），仅在回车时触发且 Code 为空；推荐改用 @bind:event="oninput" 配合 @bind:get/@bind:set 实现毫秒级实时捕获与处理。
在 maui blazor 中，`@onkeyup` 无法可靠响应移动设备虚拟键盘的每次按键（如字母、数字键），仅在回车时触发且 `code` 为空；推荐改用 `@bind:event="oninput"` 配合 `@bind:get`/`@bind:set` 实现毫秒级实时捕获与处理。
在构建跨平台 MAUI Blazor 应用时，开发者常期望像 Web 原生 <input onkeyup="..."> 那样，在用户每按下一个虚拟键盘按键（如 a、1、空格）时立即响应并处理输入内容。然而，Blazor 的 @onkeyup 事件在 iOS 和 Android 的 WebView（尤其是 MAUI 内嵌的 BlazorWebView）中存在固有局限：它不会为普通字符键触发，仅在软键盘“完成”“搜索”或“回车”等确认动作时触发，且此时 KeyboardEventArgs.Code 往往为空字符串或不可靠，导致逻辑失效。
根本原因在于：移动浏览器（及 MAUI 封装的 WebView）对 keyup 事件的派发机制与桌面不同——虚拟键盘输入通常不经过标准 DOM 键盘事件流，而是直接修改 <input> 的 value 属性，因此 oninput 事件才是更可靠、更语义化的选择。
✅ 推荐解决方案：使用 @bind:event="oninput" + 自定义 @bind:get / @bind:set
该方式绕过事件绑定缺陷，直接监听输入值变化，确保每次字符输入（包括粘贴、自动补全、语音输入）均被捕捉：
<input id="textInput" placeholder="输入文字（自动转大写）"><p><code>StringInput</code>: @StringInput</p>
@code {
private string StringInput = string.Empty;
private void OnInput(string value)
{
// 安全处理 null，并统一转大写
StringInput = (value ?? string.Empty).ToUpper();
}
}
? 关键说明：
-
@bind:event="oninput"：明确指定绑定基于input事件（而非默认的change），保证实时性； -
@bind:get提供当前值，@bind:set接收新值并执行自定义逻辑（如格式化、校验、副作用）； - 此方案完全兼容 MAUI 的
BlazorWebView，已在 iOS 17+ 和 Android 13+ 真机验证有效； - 若需同时支持键盘事件（如快捷键），仍可保留
@onkeydown处理Enter等特殊行为，但不应依赖其捕获字符输入。
⚠️ 注意事项：
- 避免混用
@bind与@oninput（如oninput="@Handler"），这会导致 Blazor 双向绑定冲突和渲染异常； - 不要尝试在
OnInput中直接操作 DOM（如document.getElementById(...).value = ...），破坏 Blazor 的状态管理； - 如需限制输入类型（如仅数字），应在
OnInput中过滤非法字符，而非依赖前端属性（type="number"在部分 Android 键盘下不可靠）。
综上，面对 MAUI Blazor 移动端键盘事件的不确定性，拥抱 oninput 绑定范式是目前最稳定、最符合 Blazor 数据流设计原则的实践路径。
