Выбор: метод 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 |
См. также
© 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