Document.queryCommandState()

使用方法

queryCommandState メソッドは、現在の選択に特定の Document.execCommand() コマンドが適用されているかどうかを知らせます。

構文

queryCommandState(String command)

commandDocument.execCommand() のコマンドです。

返値

queryCommandState() は Boolean 値、または状態が不明な場合は null を返す可能性があります。

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

仕様書

仕様書 状態 備考
HTML Editing APIs
execCommand の定義
編集者草案 初回定義

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
queryCommandStateChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 ありIE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 ありOpera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android ?

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明

関連情報