Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Range: zajednički spremnik, pomaci i sažeti raspon

Očitaj granice raspona u DOM-u, pronađi njihov najbliži zajednički čvor i provjeri označavaju li obje granice istu točku.

Verzija: Current web platform; runtime support varies

Sintaksa

range.commonAncestorContainer
range.startOffset
range.endOffset
range.collapsed

Range je DOM sučelje, a ne dio ECMAScripta 2024. Dostupnost tih svojstava ovisi o implementaciji DOM-a u okruženju izvođenja, a ne o izdanju ECMAScripta. Nemoj pretpostaviti da su dostupna u okruženju bez DOM-a. Svaka je granica par: čvor i pomak. Očitaj startOffset zajedno sa startContainer, a endOffset zajedno s endContainer.

Pomak je položaj koji se broji od nule, a ne indeks zadnjeg obuhvaćenog znaka. U čvoru CharacterData, kao što je Text, broji kodne jedinice UTF-16 prije granice, a ne znakove koje korisnik opaža. U spremniku kao što je Element broji neposredne čvorove djecu prije granice, uključujući tekst i komentare, kao u childNodes. 0 je prije prve jedinice ili prvog djeteta; puna duljina označava položaj iza zadnjeg.

commonAncestorContainer vraća najdublji čvor koji je za svaki granični spremnik ili sam spremnik ili njegov predak. Ako su oba spremnika isti čvor, vraća upravo taj čvor, čak i ako je Text. collapsed je true samo kad obje granice imaju isti čvor i isti pomak. Jednaki pomaci u različitim čvorovima nisu dovoljni.

Sva četiri svojstva instance samo su za čitanje; startOffset, endOffset i collapsed nasljeđuju se iz AbstractRange. Granice pomiči metodama setStart() i setEnd(). collapse(true) svodi raspon na početnu točku, a collapse(false) ili collapse() na završnu. Range je živ: promjene u DOM-u mogu prilagoditi njegove granice.

Primjeri

<!doctype html>
<meta charset="utf-8">
<title>DOM Range boundary points</title>
<script>
{
  const container = document.createElement('div');
  const text = document.createTextNode('A😀B');
  container.appendChild(text);

  const range = document.createRange();
  range.setStart(text, 3);
  range.setEnd(container, 1);

  const logRange = (expectedAncestor) => {
    console.log(JSON.stringify([
      range.commonAncestorContainer === expectedAncestor,
      range.startOffset,
      range.endOffset,
      range.collapsed,
      range.toString(),
    ]));
  };

  logRange(container);
  range.collapse(true);
  logRange(text);
}
</script>

Rezultat

[true,3,1,false,"B"]
[true,3,3,true,""]

Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u konzoli. Pomak `3` u tekstualnom čvoru nalazi se odmah iza emojija, koji zauzima dvije kodne jedinice UTF-16. Pomak `1` u elementu nalazi se iza njegova jedinog djeteta. Raspon zato obuhvaća `B`. Nakon `collapse(true)` obje su granice na pomaku `3` u tekstualnom čvoru, koji tako postaje zajednički spremnik.

Povezane lekcije

  • JavaScript · Lekcija 33 · Srednje · Verzija: 3

Izvori