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 des VirtualKeyboard Interfaces blendet die virtuelle Bildschirmtastatur programmatisch aus. Dies ist nützlich, wenn die Seite ihre eigene Logik für die virtuelle Tastatur mithilfe der VirtualKeyboard API implementieren muss.

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

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

Syntax

hide()

Parameter

Keine.

Rückgabewert

Undefined.

Beispiel

Der folgende Code-Schnipsel zeigt, wie das virtualkeyboardpolicy Attribut verwendet wird, um zu verhindern, dass der Browser beim Klicken oder Tippen die virtuelle Tastatur anzeigt. Der Code verwendet auch die Methoden navigator.virtualKeyboard.show() und navigator.virtualKeyboard.hide(), um die virtuelle Tastatur anzuzeigen und auszublenden, wenn eine Schaltfläche angeklickt wird:

html

<div contenteditable virtualkeyboardpolicy="manual" id="editor"></div>
<button id="edit-button">Edit</button>

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;
  });
}

Spezifikationen

Specification
VirtualKeyboard API # dom-virtualkeyboard-hide