Document: queryCommandState() 方法

已弃用：此功能不再推荐。尽管某些浏览器可能仍然支持它，但它可能已从相关的 Web 标准中删除，或者正在被弃用，或者仅出于兼容性目的而保留。避免使用它，并尽可能更新现有代码；请参阅此页面底部的兼容性表，以指导您的决策。请注意，此功能可能随时停止工作。

非标准：此功能是非标准的，并且不在标准轨道上。请勿在面向 Web 的生产站点上使用它：它不会对每个用户都有效。不同实现之间也可能存在较大的不兼容性，并且行为将来可能会发生变化。

queryCommandState() 方法将告诉您当前的选择是否应用了某个Document.execCommand() 命令。

语法

js
queryCommandState(command)

参数

command 是来自Document.execCommand() 的命令

返回值

如果状态未知，则queryCommandState() 可以返回布尔值或null。

示例

HTML

html
<div contenteditable="true">Select a part of this text!</div>
<button onclick="makeBold();">Test the state of the 'bold' command</button>

<hr />

<div id="output"></div>

JavaScript

js
function makeBold() {
  const state = document.queryCommandState("bold");
  let message;
  switch (state) {
    case true:
      message = "The bold formatting will be removed from the selected text.";
      break;
    case false:
      message = "The selected text will be displayed in bold.";
      break;
    default:
      message = "The state of the 'bold' command is indeterminable.";
      break;
  }
  document.querySelector("#output").textContent = `Output: ${message}`;
  document.execCommand("bold");
}

结果

规范

此功能不是任何当前规范的一部分。它不再有望成为标准。

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅