Obsolete
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.
The queryCommandState()
method will tell you if the current selection has a certain Document.execCommand()
command applied.
Syntax
queryCommandState(String command)
Parameters
command
is a command from Document.execCommand()
Return value
queryCommandState()
can return a Boolean
value or null
if the state is unknown.
Example
HTML
<div contenteditable="true">Select a part of this text!</div> <button onclick="makeBold();">Test the state of the 'bold' command</button>
JavaScript
function makeBold() { var state = document.queryCommandState("bold"); switch (state) { case true: alert("The bold formatting will be removed from the selected text."); break; case false: alert("The selected text will be displayed in bold."); break; case null: alert("The state of the 'bold' command is indeterminable."); break; } document.execCommand('bold'); }
Result
Specifications
Specification | Status | Comment |
---|---|---|
execCommand |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
queryCommandState | Chrome Full support 1 | Edge Full support 12 | Firefox Full support Yes | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support Yes | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- Non-standard. Expect poor cross-browser support.
- Non-standard. Expect poor cross-browser support.
- Deprecated. Not for use in new websites.
- Deprecated. Not for use in new websites.
See also
HTMLElement.contentEditable
document.designMode
- Rich-Text Editing in Mozilla
- Browser bugs related to
queryCommandState()
: Scribe's "Browser Inconsistencies" documentation