Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Selection — odabir u dokumentu

Selection predstavlja odabir u dokumentu. Saznajte više o rangeCount i dodavanju raspona pomoću addRange.

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

Sintaksa

const selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);

Selection predstavlja odabir u dokumentu; Range određuje njegove granice. Dohvatite ga pomoću window.getSelection() i provjerite je li rezultat null. To je Web API, a ne značajka ECMAScripta; Node 24 ne dokazuje podršku u preglednicima.

Selection.rangeCount je samo za čitanje: specifikacija propisuje vrijednost 0 ako je odabir prazan ili su njegove granice izvan stabla dokumenta, a inače 1. Vrijednost može biti 1 čak i kad se početna i završna granica raspona podudaraju — to ne znači da je tekst odabran.

Kad Selection.addRange(range) doda raspon, zadržava referencu na njega, a ne kopiju. Prema specifikaciji metoda ne radi ništa ako je raspon izvan stabla dokumenta ili ako Selection.rangeCount nije jednak 0. Firefox ipak omogućuje dodavanje više raspona, pa Selection.rangeCount u njemu može biti veći od 1. Nemojte se oslanjati na to da svi preglednici podržavaju više raspona. Da biste zamijenili odabir, pozovite removeAllRanges() prije dodavanja novog raspona.

Primjeri

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

  const paragraph = document.createElement('p');
  paragraph.textContent = 'Hello Selection';
  document.body.append(paragraph);

  const range = document.createRange();
  range.setStart(paragraph.firstChild, 6);
  range.setEnd(paragraph.firstChild, 15);

  try {
    selection.removeAllRanges();
    selection.addRange(range);
    console.log(selection.rangeCount + ': ' + selection.toString());

    range.collapse(true);
    console.log(selection.rangeCount + ': ' + selection.isCollapsed);
  } finally {
    selection.removeAllRanges();
    paragraph.remove();
  }
})();

Rezultat

1: Selection
1: true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori