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

CKTIS / JavaScript

Range: spoločný kontajner, posuny a zbalený rozsah

Prečítaj hranice rozsahu v DOM, nájdi ich najbližší spoločný uzol a over, či obe hranice označujú presne ten istý bod.

Verzia: Current web platform; runtime support varies

Syntax

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

Range je rozhranie DOM, nie súčasť ECMAScriptu 2024. Dostupnosť týchto vlastností závisí od implementácie DOM v hostiteľskom prostredí, nie od verzie ECMAScriptu. Nepredpokladaj, že sú dostupné v prostredí bez DOM. Každú hranicu určuje dvojica: uzol a posun. Čítaj startOffset spolu so startContainer a endOffset spolu s endContainer.

Posun je pozícia počítaná od nuly, nie index posledného zahrnutého znaku. V uzle CharacterData, napríklad Text, počíta kódové jednotky UTF-16 pred hranicou, nie znaky vnímané používateľom. V kontajneri, ako je Element, počíta priame podradené uzly pred hranicou vrátane textu a komentárov, tak ako childNodes. 0 je pred prvou jednotkou alebo prvým podradeným uzlom; celková dĺžka označuje pozíciu za posledným.

commonAncestorContainer vracia najhlbšie vnorený uzol, ktorý je pre každý kontajner hranice buď týmto kontajnerom, alebo jeho predkom. Ak sú oba kontajnery ten istý uzol, vráti ho, aj keď ide o Text. collapsed je true iba vtedy, keď obe hranice majú rovnaký uzol aj posun. Rovnaké posuny v rôznych uzloch nestačia.

Všetky štyri vlastnosti inštancie sú len na čítanie; startOffset, endOffset a collapsed sú zdedené z AbstractRange. Hranice posúvaj pomocou setStart() a setEnd(). collapse(true) zbalí rozsah na začiatok; collapse(false) alebo collapse() na koniec. Range je živý: zmeny v DOM môžu upraviť jeho hranice.

Príklady

<!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>

Výsledok

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

Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výstup v konzole. Posun `3` v textovom uzle je tesne za emoji, ktoré zaberá dve kódové jednotky UTF-16. Posun `1` v prvku je za jeho jediným podradeným uzlom. Rozsah teda obsahuje `B`. Po `collapse(true)` sú obe hranice na posune `3` v textovom uzle, ktorý sa tak stane spoločným kontajnerom.

Súvisiace lekcie

  • JavaScript · Lekcia 33 · Stredne pokročilá · Verzia: 3

Zdroje