HTMLElement: virtualKeyboardPolicy-Eigenschaft

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.

Die virtualKeyboardPolicy-Eigenschaft des HTMLElement-Interfaces ermittelt und setzt einen String, der das Verhalten der virtuellen On-Screen-Tastatur auf Geräten wie Tablets, Mobiltelefonen oder anderen Geräten angibt, bei denen möglicherweise keine Hardwaretastatur verfügbar ist, wenn die Inhalte des Elements bearbeitbar sind (zum Beispiel, wenn es sich um ein <input>- oder <textarea>-Element handelt oder ein Element mit dem contenteditable-Attribut, das gesetzt ist).

Es spiegelt den Wert des globalen HTML-Attributs virtualkeyboardpolicy wider.

Wert

Ein enumerierter Wert; mögliche Werte sind:

"auto" oder ein leerer String ("")

Der Browser zeigt die virtuelle Tastatur automatisch an, wenn der Benutzer das Element antippt oder fokussiert.

"manual"

Der Browser zeigt die virtuelle Tastatur nicht automatisch an: Das Anzeigen/Verbergen der virtuellen Tastatur wird manuell durch das Skript gesteuert.

Beispiele

Das folgende Beispiel zeigt, wie das Verhalten der virtuellen On-Screen-Tastatur über ein Skript gesteuert werden kann:

js
const element = document.querySelector("input");

// the on-screen virtual keyboard behavior will be controlled by script manually
element.virtualKeyboardPolicy = "manual";

Spezifikationen

Specification
VirtualKeyboard API
# dom-elementcontenteditable-virtualkeyboardpolicy

Browser-Kompatibilität

Siehe auch