VirtualKeyboard: geometrychange Ereignis

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 vor der Verwendung auf produktiven Webseiten.

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 Zuständen Ein- und Ausgeblendet umgeschaltet wird.

Das geometrychange-Ereignis ist nützlich, um zu erkennen, wann die Bildschirmtastatur erscheint und verschwindet, damit Sie das Layout entsprechend anpassen können. Dies ist notwendig, wenn Sie die Virutal Keyboard API verwenden, um die standardmäßige automatische Größenanpassung des Ansichtsfensters durch den Browser zu deaktivieren, wenn die Bildschirmtastatur ein- und ausgeblendet wird.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("geometrychange", (event) => { })

ongeometrychange = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

Der folgende Codeausschnitt verwendet das geometrychange-Ereignis, um zu erkennen, wann sich die Geometrie der Bildschirmtastatur ändert, und greift dann auf die boundingRect-Eigenschaft zu, um die Größe und Position der Bildschirmtastatur 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

Siehe auch