Kurzreferenz

DOM Selection API Spickzettel

Kurzreferenz fuer die DOM-Selection-API des Browsers mit document.getSelection: Range-Verwaltung, Caret-Kollaps und Auswahlereignisse.

· Veröffentlicht

Kurzreferenz fuer die Browser-DOM-Selection-API (window.getSelection()).

🔗 Verwandt: DOM Range API Spickzettel

Aktuelle Auswahl abrufen (Getting Current Selection)

const selection = window.getSelection(); // oder document.getSelection()
const selectedText = selection.toString();

Range-Verwaltung (Range Management)

// Zugriff auf den aktiven Bereich
const rangeCount = selection.rangeCount;
if (rangeCount > 0) {
  const currentRange = selection.getRangeAt(0);
}

// Alle aktiven Selektionen aufheben (hebt Textauswahl auf)
selection.removeAllRanges();

// Neue Auswahl programmatisch setzen
selection.addRange(range);

// Einen bestimmten Bereich entfernen
selection.removeRange(range);

Caret und Zusammenklappen (Caret & Collapsing)

// Auswahl auf einen einzigen Punkt (Caret) zusammenklappen
selection.collapse(parentNode, offset);

// Auf Start- oder Endgrenze zusammenklappen
selection.collapseToStart();
selection.collapseToEnd();

// Prueft, ob die Auswahl derzeit zusammengeklappt ist (blinkender Cursor)
const isCaret = selection.isCollapsed;

Auswahl loeschen (Selection Deletion)

// Entfernt den ausgewaehlten Inhalt aus dem Live-DOM-Dokument
selection.deleteFromDocument();

Auswahlaenderungs-Ereignisse (Selection Change Events)

document.addEventListener('selectionchange', () => {
  const sel = document.getSelection();
  // Aenderung protokollieren
  console.log('Selection changed:', sel.toString());
});

Verwandte Themen