Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Range: společný kontejner, posuny a sbalený rozsah

Přečti hranice rozsahu v DOM, najdi jejich nejbližší společný uzel a ověř, zda obě hranice označují přesně stejný bod.

Verze: Current web platform; runtime support varies

Syntaxe

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

Range je rozhraní DOM, nikoli součást ECMAScriptu 2024. Dostupnost těchto vlastností závisí na implementaci DOM v hostitelském prostředí, nikoli na verzi ECMAScriptu. Nepředpokládej, že jsou dostupné v prostředí bez DOM. Každou hranici určuje dvojice: uzel a posun. Čti startOffset společně se startContainer a endOffset společně s endContainer.

Posun je pozice počítaná od nuly, nikoli index posledního zahrnutého znaku. V uzlu CharacterData, například Text, udává počet kódových jednotek UTF-16 před hranicí, nikoli počet znaků vnímaných uživatelem. V kontejneru, jako je Element, počítá přímé podřízené uzly před hranicí, včetně textu a komentářů, stejně jako childNodes. 0 je před první jednotkou nebo prvním podřízeným uzlem; celková délka je pozice za posledním.

commonAncestorContainer vrací nejhlouběji zanořený uzel, který je pro každý kontejner hranice buď tímto kontejnerem, nebo jeho předkem. Pokud jsou oba kontejnery stejný uzel, vrátí právě ten, i když jde o Text. collapsed je true pouze tehdy, když obě hranice mají stejný uzel i posun. Stejné posuny v různých uzlech nestačí.

Všechny čtyři vlastnosti instance jsou jen pro čtení; startOffset, endOffset a collapsed jsou zděděné z AbstractRange. Hranice posouvej pomocí setStart() a setEnd(). collapse(true) sbalí rozsah na začátek; collapse(false) nebo collapse() na konec. Range je živý: změny v DOM mohou jeho hranice upravit.

Pří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ýsledek

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

Ulož příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj výstup v konzoli. Posun `3` v textovém uzlu je těsně za emoji, které zabírá dvě kódové jednotky UTF-16. Posun `1` v prvku je za jeho jediným podřízeným uzlem. Rozsah tedy obsahuje `B`. Po `collapse(true)` jsou obě hranice na posunu `3` v textovém uzlu, který se tak stane společným kontejnerem.

Související lekce

  • JavaScript · Lekce 33 · Středně pokročilá · Verze: 3

Zdroje