ElementReference.FocusAsync() 用于让 HTML 元素获得焦点，需 await 调用且仅在组件已渲染、元素存在于 DOM 时有效；应通过 @ref 绑定 ElementReference，避免在 OnInitialized 中调用，推荐在 OnAfterRender（配合标志位）或用户事件中使用，并注意元素状态与兼容性。
在 Blazor 中，ElementReference.FocusAsync() 用于让某个 HTML 元素获得焦点，常用于表单自动聚焦、键盘导航或用户交互触发后快速定位输入框。它返回一个 ValueTask，需用 await 调用，且只在组件已渲染、元素真实存在于 DOM 中时才有效。
确保 ElementReference 已正确绑定
必须先通过 @ref 将元素引用到 ElementReference 类型的字段或属性上，不能直接对字符串或未初始化的变量调用：
在 Razor 文件中：在 C# 代码块中声明：private ElementReference myInput;避免在 OnInitialized 中立即调用 FocusAsync —— 此时 DOM 尚未生成，会静默失败
推荐在 OnAfterRender 或事件处理中调用
最稳妥的时机是 OnAfterRender（配合标志位）或用户触发的事件（如按钮点击、输入完成）：
点击按钮聚焦：await myInput.FocusAsync(); 放在 async Task HandleClick() { ... } 内首次渲染后自动聚焦：用私有布尔字段标记是否已聚焦，在 OnAfterRender 中检查并调用，之后设为 true 防止重复注意：不要在 OnInitializedAsync 中 await FocusAsync，它不保证 DOM 可用
处理可能的异常和兼容性
FocusAsync 在元素被移除、禁用（disabled）、隐藏（display: none 或 visibility: hidden）时可能无效，但通常不会抛异常。可做基础防护：
检查元素是否“可聚焦”：确保不是 disabled 状态，且 tabindex 未设为 -1（除非你主动控制）若需兼容旧浏览器或 SSR 初始阶段，建议包裹在 try/catch 或判断 JSRuntime 是否可用（服务端渲染时 JS 不可用）Blazor WebAssembly 和 Blazor Server 均支持该方法，但 Server 模式下焦点行为受 SignalR 延迟影响，视觉反馈可能稍滞后
基本上就这些。只要引用存在、时机得当、元素可交互，FocusAsync 就能可靠工作。
以上就是Blazor ElementReference.FocusAsync() 使用方法的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1442952.html
微信扫一扫 
支付宝扫一扫 
