大网数据广告活动
Web 标准与前端开发

VirtualKeyboard

· 52CE 我爱测

虚拟键盘 API 的 **`VirtualKeyboard`** 接口用于具有屏幕虚拟键盘的设备(如平板电脑、手机或其他没有物理键盘的设备)。

VirtualKeyboard API

虚拟键盘 API 的 VirtualKeyboard 接口用于具有屏幕虚拟键盘的设备(如平板电脑、手机或其他没有物理键盘的设备)。

VirtualKeyboard 接口使你可以选择不使用浏览器自动处理屏幕虚拟键盘的方式——通过减少视口的高度来为虚拟键盘腾出空间。你可以阻止浏览器改变视口大小、检测虚拟键盘的位置和大小,并通过编程方式显示或隐藏虚拟键盘。

你可以通过 navigator.virtualKeyboard 访问 VirtualKeyboard 接口。

实例属性

VirtualKeyboard 接口从其父接口 EventTarget 继承属性。

  • VirtualKeyboard.boundingRect
    • : 描述虚拟键盘几何结构的 DOMRect。
  • VirtualKeyboard.overlaysContent
    • : 一个Boolean,定义浏览器是否应停止处理屏幕虚拟键盘。

实例方法

VirtualKeyboard 接口从其父接口 EventTarget 继承方法。

  • VirtualKeyboard.show()
    • : 显示虚拟键盘。
  • VirtualKeyboard.hide()
    • : 隐藏虚拟键盘。

事件

  • VirtualKeyboard.geometrychange_event
    • : 当屏幕虚拟键盘的几何形状发生变化时(即虚拟键盘显示或隐藏时)触发。

示例

以下示例演示如何选择不使用自动虚拟键盘行为,并检测网页中虚拟键盘的几何形状:

if ("virtualKeyboard" in navigator) {
  navigator.virtualKeyboard.overlaysContent = true;

  navigator.virtualKeyboard.addEventListener("geometrychange", (event) => {
    const { x, y, width, height } = event.target.boundingRect;
  });
}

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。