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

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
hide
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.

Siehe auch