VirtualKeyboard:geometrychange 事件

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

实验性: 这是一项实验性技术
在将其用于生产之前,请仔细检查浏览器兼容性表格

安全上下文: 此项功能仅在一些支持的浏览器安全上下文(HTTPS)中可用。

VirtualKeyboard 接口的 geometrychange 事件会在屏幕虚拟键盘在显示和隐藏状态之间切换时触发。

geometrychange 事件对于检测虚拟键盘何时出现和消失(以便根据需要调整布局)非常有用。这在使用虚拟键盘 API 以禁用浏览器在虚拟键盘显示和隐藏时自动调整视口大小时尤为重要。

语法

addEventListener() 等方法中使用事件名称,或者设置事件处理器属性。

js
navigator.virtualKeyboard.addEventListener("geometrychange", (event) => {});

navigator.virtualKeyboard.ongeometrychange = (event) => {};

事件类型

通用 Event

示例

以下代码片段使用 geometrychange 事件来检测虚拟键盘几何属性的变化,然后访问 boundingRect 属性来查询虚拟键盘的大小和位置:

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

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

规范

Specification
VirtualKeyboard API
# dom-virtualkeyboard-ongeometrychange

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
geometrychange event
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

参见