大网数据广告活动
Web 标准与前端开发

VirtualKeyboard:show() 方法

· 52CE 我爱测

VirtualKeyboard 接口的 **`show()`** 方法用于以编程方式显示屏幕上的虚拟键盘。这在页面需要实现自己的虚拟键盘逻辑时特别有用,特别是在 `contenteditable` 元素上使用 `virtualkeyboardpolicy` 属性时,如控制 `contenteditable` 元素上的虚拟键盘所解释的那样。

VirtualKeyboard API

VirtualKeyboard 接口的 show() 方法用于以编程方式显示屏幕上的虚拟键盘。这在页面需要实现自己的虚拟键盘逻辑时特别有用,特别是在 contenteditable 元素上使用 virtualkeyboardpolicy 属性时,如控制 contenteditable 元素上的虚拟键盘所解释的那样。

该方法仅在当前焦点元素是表单控件(如 input 或 textarea 元素),或者当前焦点元素是 contenteditable,且当前焦点元素的 virtualKeyboardPolicy 属性设置为 manual 而 inputmode 没有设置为 none 时起作用。

show() 方法始终返回 undefined,并触发一个 VirtualKeyboard.geometrychange_event 事件。

语法

show()

参数

无。

返回值

undefined。

示例

下面的代码片段展示了如何使用 virtualkeyboardpolicy 属性阻止浏览器在点击或轻触时显示虚拟键盘。代码还使用 navigator.virtualKeyboard.show() 和 navigator.virtualKeyboard.hide() 方法,在点击按钮时显示和隐藏虚拟键盘:

<div contenteditable virtualkeyboardpolicy="manual" id="editor"></div>
<button id="edit-button">编辑</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 = "编辑";
      } else {
        editor.focus();
        navigator.virtualKeyboard.show();
        editButton.textContent = "保存更改";
      }

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

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。