Spec-Zone.ru › Web APIs

Выбор: метод empty()

Базовая Широко доступная

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

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Метод Selection.empty() удаляет все диапазоны из выбора, оставляя свойства anchorNode и focusNode равными null и ничего не выбранным. При вызове этого метода в документе генерируется событие selectionchange.

Примечание: Этот метод является псевдонимом для метода Selection.removeAllRanges().

Синтаксис

empty()

Параметры

Нет.

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

Ничего (undefined).

Примеры

Этот пример отображает сообщение, когда на странице что-то выбрано или нет. Для этого он прослушивает событие selectionchange в документе. Также есть кнопка, которая очищает любой выбор, вызывая Selection.empty(). Когда это происходит, выбор изменяется, и сообщение обновляется.

<p>
  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse laoreet
  urna eget sapien venenatis, eget facilisis diam mattis.
</p>
<button>Clear selection</button>
<pre id="log"></pre>
const log = document.getElementById("log");

// The selection object is a singleton associated with the document
const selection = document.getSelection();

// Logs if there is a selection or not
function newSelectionHandler() {
  if (selection.rangeCount !== 0) {
    log.textContent = "Some text is selected.";
  } else {
    log.textContent = "No selection on this document.";
  }
}

document.addEventListener("selectionchange", () => {
  newSelectionHandler();
});

newSelectionHandler();

// The button cancel all selection ranges
const button = document.querySelector("button");
button.addEventListener("click", () => {
  selection.empty();
});

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

Спецификация
Selection API
# dom-selection-removeallranges

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
empty 1 12 55 15 1.3 18 55 14 1 1.0 4.4

См. также

  • Selection.removeAllRanges()
  • selectionchange

© 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/Selection/empty

Spec-Zone.ru

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