Spec-Zone.ru › Web APIs

Документ: метод queryCommandState()

Устарело: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её поддерживать, она может быть удалена из соответствующих веб-стандартов, может быть в процессе удаления или оставаться только для совместимости. Избегайте её использования и обновляйте существующий код, если это возможно; см. таблицу совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любой момент.

Нестандартно: Эта функция нестандартна и не является частью стандартов. Не используйте её на производственных сайтах, ориентированных на веб: она не будет работать для всех пользователей. Также могут быть существенные различия в реализации, и поведение может измениться в будущем.

Метод queryCommandState() покажет, применен ли к текущему выделению определённый Document.execCommand() команду.

Синтаксис

queryCommandState(command)

Параметры

command

Команда из Document.execCommand()

Значение возврата

queryCommandState() может возвращать булево значение или null, если состояние неизвестно.

Пример

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

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

Результат

Спецификации

Эта функция не входит в состав текущих спецификаций. Она больше не соответствует требованиям к стандарту.

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
queryCommandState 1 12 69
1–69Поддерживается только для HTMLDocument, а не для всех Document объектов.
≤12.1 2 18 79
4–79Поддерживается только для HTMLDocument, а не для всех Document объектов.
≤12.1 1 1.0 4.4

См. также

  • HTMLElement.contentEditable
  • document.designMode
  • Ошибки браузеров, связанные с queryCommandState(): Документация Scribe по "Несоответствиям браузеров"

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/queryCommandState

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API