HTMLElement:virtualKeyboardPolicy 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

HTMLElement 接口的 virtualKeyboardPolicy 属性用于获取和设置一个字符串,该字符串指示设备(如平板电脑、手机或其他可能没有硬件键盘的设备)上的屏幕虚拟键盘的行为,前提是该元素的 HTMLElement 内容可编辑(例如,它是一个 <input><textarea> 元素,或具有 contenteditable 属性设置为 true 的元素)。

它反映了 virtualkeyboardpolicy HTML 全局属性的值。

这是一个枚举值;可能的值有:

"auto" 或空字符串 ("")

当用户点击或聚焦该元素时,浏览器会自动显示虚拟键盘。

"manual"

浏览器不自动显示虚拟键盘:虚拟键盘的显示/隐藏由脚本手动控制。

示例

下面的示例展示了如何通过脚本控制屏幕虚拟键盘的行为

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

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

规范

规范
VirtualKeyboard API
# dom-elementcontenteditable-virtualkeyboardpolicy

浏览器兼容性

另见