Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Selection.getRangeAt — získanie rozsahu výberu

Selection.getRangeAt(0) vracia objekt Range spojený s výberom v dokumente, nie jeho kópiu.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

selection.getRangeAt(index)

selection.getRangeAt(index) sprístupňuje rozsah výberu. Je to webové API prehliadača, nie funkcia ECMAScriptu; Node 24 nepotvrdzuje jeho podporu.

Pred volaním s indexom 0 skontrolujte, či platí selection !== null a selection.rangeCount > 0. Podľa špecifikácie musí metóda vyvolať výnimku IndexSizeError, ak index nie je 0, výber je prázdny alebo niektorý z jeho hraničných bodov leží mimo stromu dokumentu. Prehliadače toto pravidlo nedodržiavajú vždy: Firefox môže sprístupniť viac rozsahov výberu, takže môže fungovať aj nenulový index. Ak hraničný bod leží v strome Shadow DOM, nespoliehajte sa na to, že prehliadač túto výnimku vyvolá. Aj výber zbalený na pozíciu textového kurzora môže mať rozsah.

Výsledkom je referencia: zmena rozsahu ovplyvňuje výber, kým zostávajú prepojené. Opakované volania s rovnakým indexom vracajú ten istý objekt, pokiaľ rozsah nebol nahradený alebo odstránený. Špecifikácia má status Working Draft; nejde o tabuľku kompatibility prehliadačov.

Príklady

(() => {
  const selection = window.getSelection();
  if (!selection || !document.body) {
    throw new Error("An active browser document is required.");
  }

  const element = document.createElement("p");
  element.textContent = "Hello world";
  document.body.append(element);

  try {
    selection.removeAllRanges();
    const range = document.createRange();
    range.setStart(element.firstChild, 0);
    range.setEnd(element.firstChild, 5);
    selection.addRange(range);

    if (selection.rangeCount === 0) {
      throw new Error("No selection range is available.");
    }
    const selectedRange = selection.getRangeAt(0);
    console.log(selectedRange.toString());
    console.log(selectedRange === selection.getRangeAt(0));
  } finally {
    selection.removeAllRanges();
    element.remove();
  }
})();

Výsledok

Hello
true

Kód a výstup boli overené v izolovanom prostredí prehliadača Chromium. Príklad získa jediný rozsah s indexom `0` a overí, že druhé volanie vráti ten istý objekt. Netestuje nenulové indexy ani hraničné body v strome Shadow DOM.

Zdroje