HTML 中不存在 virtualkeyboardpolicy 全局属性，它既非标准也未被任何浏览器实现；所谓协同纯属误传，源于对 viewport meta 指令、实验性 API 或相似属性的混淆。
HTML 中没有 virtualkeyboardpolicy 全局属性，它根本不存在于任何浏览器实现或 W3C 规范中。所谓“协同”是建立在错误前提上的伪命题——你没法让一个不存在的 HTML 属性和 JS API 协同工作。
为什么 virtualkeyboardpolicy 会被误传
这个名称常见于三类混淆：
- 把
<meta name="viewport" content="virtualkeyboardpolicy=auto">错当成 HTML 元素属性（实际它是<meta>标签的content值，且仅在 Chromium 105+ 中作为 viewport 指令存在） - 把实验性 Chromium 的
navigator.virtualKeyboard.overlaysContent误标为“策略属性” - 把
inputmode或enterkeyhint这类真实存在的标准属性记混成名字相近的虚构属性
navigator.virtualKeyboard 的真实启用条件
该 API 仅在 Chrome 105+ / Edge 111+ 中可用，且必须同时满足：
-
<meta name="viewport" content="height=device-height, virtualkeyboardpolicy=auto">已声明（缺一不可） - 页面处于前台（
document.visibilityState === "visible"） - 用户手势上下文未丢失（
focus()必须在click/touchend同步调用，不能进setTimeout或Promise.then） -
navigator.virtualKeyboard对象存在且overlaysContent可写（需手动设为true才禁用浏览器自动缩放）
不满足任一条件，geometrychange 事件都不会触发，boundingRect 会返回空值。
立即学习“前端免费学习笔记（深入）”；
iOS Safari 和 Firefox 完全无视该 API
这不是“兼容性差”，而是明确不支持：
- Safari WebKit 源码中无
virtualKeyboard相关实现，也无计划支持 - Firefox 的 bug tracker 明确标记为 “WONTFIX”
- 所有 WebView（如 Cordova、React Native WebView、微信内置浏览器）均不识别
virtualkeyboardpolicy或navigator.virtualKeyboard - 试图在 iOS 上监听
geometrychange会导致静默失败，且不会 fallback 到resize
若你在跨平台项目中依赖它，上线后 iOS 用户将完全收不到键盘显隐通知，输入框被遮挡问题无法感知。
真正能落地的键盘状态检测方案
放弃对虚构属性和非标 API 的幻想，转向稳定路径：
- 用
window.visualViewport?.onresize+ 防抖检测高度突变（Android/iOS 均有效） - 聚焦时立即调用
input.scrollIntoView({ block: 'nearest' })，比等事件更及时 - CSS 中用
padding-bottom: env(keyboard-inset-bottom, 0)（iOS 支持，Android 尚未支持，但降级安全） - 避免
inert与键盘逻辑共存：键盘弹出时若页面部分区域被inert，Safari 会中断focus流程，导致键盘不弹；应改用pointer-events: none+tabindex="-1"组合控制可聚焦性
最易被忽略的一点：visualViewport 在 iOS Safari 中默认禁用，需在 <meta name="viewport"> 中显式包含 viewport-fit=cover 才能启用。漏掉这行，你的防抖检测就永远收不到 resize。
