Spec-Zone.ru › Web APIs

Метод Selection: removeAllRanges()

Базовая реализация Широко поддерживается

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

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

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

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

Синтаксис

removeAllRanges()

Параметры

Нет.

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

Ничего (undefined).

Примеры

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

<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.removeAllRanges();
});

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

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

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
removeAllRanges 1 12 1 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4

См. также

  • Selection.empty()
  • 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/removeAllRanges

Spec-Zone.ru

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