Document.queryCommandEnabled()

已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它,但也许已从相关的 web 标准中移除,也许正准备移除或出于兼容性而保留。请尽量不要使用该特性,并更新现有的代码;参见本页面底部的兼容性表格以指导你作出决定。请注意,该特性随时可能无法正常工作。

备注: 该方法在部分浏览器返回的结果是不可预料的。因此,建议使用 execCommand 的返回值直接判断,或通过其他方式嗅探,而非使用该方法。

Document.queryCommandEnabled() 方法可查询浏览器中指定的编辑指令是否可用。

语法

js
var isEnabled = document.queryCommandEnabled(command);

参数

command

待查询的是否可用的指令。

返回值

返回 Boolean 值,true 表示指令可用,false表示指令不可用。

备注

  • 经过测试,在部分浏览器它永远返回 false,而 IE 浏览器即使对于同样支持的属性也可能有不同返回值;有时 IE 还会对不支持的属性抛出异常而不是返回 false
  • 对于 "cut""copy" 指令,只有当用户启动的线程调用该方法时才返回 true。
  • "paste" 指令不仅当特性不可用时返回 false ,脚本权限不足时也一样。

示例

js
var flg = document.queryCommandEnabled("SelectAll");

if (flg) {
  document.execCommand("SelectAll", false, null); // command is enabled, run it
}

规范

此特性不属于任何规范,也不再有望被标准化。

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
queryCommandEnabled
DeprecatedNon-standard

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
Has more compatibility info.

参考资料