Spec-Zone.ru › Web APIs

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

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

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

Метод Document.queryCommandEnabled() сообщает, включена ли указанная команда редактора в браузере.

Синтаксис

document.queryCommandEnabled(command)

Параметры

command

Команда, для которой нужно определить поддержку.

Возвращаемое значение

Возвращает булево значение, которое true если команда включена и false если команда отключена.

Примечания

  • Для команд "cut" и "copy" метод возвращает true только при вызове из потока, инициированного пользователем.
  • Команда "paste" возвращает false не только в случае недоступности функции, но и если у скрипта, вызывающего её, недостаточно привилегий для выполнения действия.

Пример

const flg = document.queryCommandEnabled("SelectAll");

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

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

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

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

Десктопные Мобильные
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на iOS Samsung Internet WebView Android
queryCommandEnabled 1 12 69
41–69Поддерживается только для HTMLDocument, а не для всех Document объектов.
1–41["Поддерживается только для HTMLDocument, а не для всех Document объектов.", "queryCommandEnabled с аргументами cut, copy или paste будут вызывать ошибки, если у скрипта нет специальных привилегий."]
≤12.1 2 18 79
41–79Поддерживается только для HTMLDocument, а не для всех Document объектов.
4–41["Поддерживается только для HTMLDocument, а не для всех Document объектов.", "queryCommandEnabled с аргументами cut, copy или paste будут вызывать ошибки, если у скрипта нет специальных привилегий."]
≤12.1 1 1.0 4.4

См. также

  • Document.execCommand()
  • Document.queryCommandSupported()

© 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/queryCommandEnabled

Spec-Zone.ru

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