VirtualKeyboard: hide()-Methode

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.

Die hide()-Methode der VirtualKeyboard-Schnittstelle blendet die virtuelle Bildschirmtastatur programmatisch aus. Dies ist nützlich, wenn die Seite ihre eigene Logik für virtuelle Tastaturen mit der VirtualKeyboard API implementieren muss.

Diese Methode funktioniert nur, wenn das virtualKeyboardPolicy-Attribut des derzeit fokussierten Elements auf manual gesetzt ist und inputmode nicht auf none gesetzt ist.

Die hide()-Methode gibt immer undefined zurück und löst ein geometrychange-Ereignis aus.

Syntax

js
hide()

Parameter

Keine.

Rückgabewert

Undefined.

Beispiel

Der untenstehende Codeausschnitt zeigt, wie das virtualkeyboardpolicy-Attribut verwendet wird, um zu verhindern, dass der Browser die virtuelle Tastatur bei einem Klick oder Tipp anzeigt. Der Code verwendet auch die navigator.virtualKeyboard.show()- und navigator.virtualKeyboard.hide()-Methoden, um die virtuelle Tastatur anzuzeigen oder auszublenden, wenn eine Schaltfläche angeklickt wird:

html
<div contenteditable virtualkeyboardpolicy="manual" id="editor"></div>
<button id="edit-button">Edit</button>
<script>
  if ("virtualKeyboard" in navigator) {
    const editor = document.getElementById("editor");
    const editButton = document.getElementById("edit-button");
    let isEditing = false;

    editButton.addEventListener("click", () => {
      if (isEditing) {
        navigator.virtualKeyboard.hide();
        editButton.textContent = "Edit";
      } else {
        editor.focus();
        navigator.virtualKeyboard.show();
        editButton.textContent = "Save changes";
      }

      isEditing = !isEditing;
    });
  }
</script>

Spezifikationen

Specification
VirtualKeyboard API
# dom-virtualkeyboard-hide

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch