Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

VirtualKeyboard: geometrychange-Ereignis

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

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 der VirtualKeyboard-Schnittstelle wird ausgelöst, wenn die virtuelle Bildschirmtastatur ein- oder ausgeblendet wird.

Mit dem geometrychange-Ereignis können Sie erkennen, wann die virtuelle Tastatur erscheint oder verschwindet, und das Layout entsprechend anpassen. Dies ist erforderlich, wenn Sie mit der Virtual Keyboard API verhindern, dass der Browser die Größe des Viewports beim Ein- und Ausblenden der virtuellen Tastatur automatisch anpasst.

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

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

Alternativ können Sie einen Wert zur Event-Handler-Eigenschaft der Schnittstelle zuweisen:

js
ongeometrychange = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

Der folgende Codeausschnitt verwendet das geometrychange-Ereignis, um Änderungen an der Geometrie der virtuellen Tastatur zu erkennen. Anschließend greift er auf die Eigenschaft boundingRect zu, um 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

Spezifikation
VirtualKeyboard API
# dom-virtualkeyboard-ongeometrychange

Browser-Kompatibilität

Siehe auch