Selection: removeAllRanges()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Selection.removeAllRanges()-Methode entfernt alle Bereiche aus der Auswahl, sodass die Eigenschaften anchorNode und focusNode gleich null sind und nichts ausgewählt ist. Wenn diese Methode aufgerufen wird, wird ein selectionchange-Ereignis im Dokument ausgelöst.
Hinweis:
Diese Methode ist ein Alias für die Selection.empty()-Methode.
Syntax
removeAllRanges()
Parameter
Keine.
Rückgabewert
Keiner (undefined).
Beispiele
Dieses Beispiel zeigt eine Nachricht an, wenn etwas auf der Seite ausgewählt ist oder nicht. Es tut dies, indem es dem Dokument auf das selectionchange-Ereignis lauscht. Es gibt auch eine Schaltfläche, die jede Auswahl löscht, indem sie Selection.removeAllRanges() aufruft. Wenn dies geschieht, wird die Auswahl geändert und die Nachricht wird aktualisiert.
<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();
});
Spezifikationen
| Spezifikation |
|---|
| Selection API # dom-selection-removeallranges |