Document: queryCommandState() メソッド

Deprecated

Avoid using this feature in new projects. The execCommand() method is "not implemented consistently or fully by user agents, and it is not expected that this will change in the foreseeable future." This feature may be a candidate for removal from web standards or browsers.

Consider using the following features instead: Async clipboardまたはcontenteditable.

もっと詳しく
完全な互換性情報を見る

非標準: この機能は標準化されていません。非標準の機能はブラウザーの対応が限られ、将来的に変更または削除される可能性があるため、本番環境での使用は推奨されません。ただし、標準の選択肢が存在しない特定のケースでは、有効な代替手段となる場合があります。

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

構文

queryCommandState(command)

<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>

hr,
button {
  margin: 1rem 0;
}

JavaScript

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");
}

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって 2024年6月26日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告

Document: queryCommandState() メソッド

構文

引数

返値

例

HTML

JavaScript

結果

仕様書

ブラウザーの互換性

関連情報

MDN の改良に協力