VirtualKeyboard: geometrychange Event

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Das geometrychange-Ereignis des VirtualKeyboard-Interfaces wird ausgelöst, wenn die Bildschirmtastatur zwischen den sichtbaren und versteckten Zuständen umgeschaltet wird.

Das geometrychange-Ereignis ist nützlich, um zu erkennen, wann die virtuelle Tastatur erscheint und verschwindet, sodass Sie das Layout entsprechend anpassen können. Dies ist notwendig, wenn die Virtual Keyboard API verwendet wird, um die automatische Anpassung der Größe des Ansichtsfensters durch den Browser zu deaktivieren, wenn die virtuelle Tastatur angezeigt und ausgeblendet wird.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder legen Sie eine Ereignis-Handler-Eigenschaft fest.

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

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

Ereignistyp

Ein generisches Event.

Beispiele

Das folgende Codebeispiel verwendet das geometrychange-Ereignis, um zu erkennen, wann sich die Geometrie der virtuellen Tastatur ändert, und greift dann auf die boundingRect-Eigenschaft zu, um die Größe und Position der virtuellen Tastatur abzufragen:

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

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

Spezifikationen

Specification
VirtualKeyboard API
# dom-virtualkeyboard-ongeometrychange

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch