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

CKTIS / JavaScript

Element — struktura DOM, geometrie a posouvání

Element představuje prvek DOM, nikoli libovolný uzel. Poskytuje navigaci, atributy a nahrazování obsahu; prohlížeče navíc zpřístupňují měření rozvržení a posouvání. Rozlišujte strukturu stromu, rozměry klientské oblasti a obdélníky vztažené k výřezu.

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

Syntaxe

element.clientWidth; element.clientHeight; element.clientLeft; element.clientTop; element.scrollHeight; element.scrollTop; element.scrollTop = y; element.getBoundingClientRect(); element.getClientRects(); element.scrollIntoView({ block: "nearest", behavior: "instant" }); element.replaceChildren(...nodesOrStrings); element.children; element.tagName; element.parentElement; element.previousElementSibling; element.nextElementSibling; element.hasAttribute(name); element.toggleAttribute(name, force);

Element představuje prvek DOM. Element.children je živá kolekce přímých potomků, kteří jsou prvky; text a komentáře vynechává. Element.parentElement, Element.previousElementSibling a Element.nextElementSibling vracejí prvek nebo null. Element.tagName udává kvalifikovaný název; názvy HTML prvků v HTML dokumentech jsou psány velkými písmeny.

Element.hasAttribute(name) ověřuje přítomnost atributu. Element.toggleAttribute(name, force) vynutí přítomnost při true a nepřítomnost při false; bez force stav přepne. Vrací výslednou přítomnost. Element.replaceChildren(...nodesOrStrings) nahradí všechny potomky; řetězce se považují za text, nikoli za HTML. Bez argumentů odstraní všechny potomky.

U typického blokového prvku udávají Element.clientWidth a Element.clientHeight vnitřní šířku a výšku včetně vnitřního odsazení, ale bez rámečku a prostoru zabraného posuvníky. U běžného řádkového prvku span vracejí obě vlastnosti 0, i když má prvek vnitřní odsazení a viditelný obsah. Ve standardním režimu vracejí u kořenového prvku rozměry výřezu bez posuvníků, nikoli rozměry jeho vlastní oblasti vymezené hranou vnitřního odsazení. Element.clientLeft a Element.clientTop udávají odsazení klientské oblasti od okraje; mohou zahrnovat posuvník. Element.scrollHeight zahrnuje i obsah přesahující svisle. Tato měření jsou celá čísla. Zapisovatelný Element.scrollTop udává svislý posun a může být desetinný, případně záporný v obrácených rozvrženích.

Element.getBoundingClientRect() vrací ohraničující obdélník; Element.getClientRects() vrací obdélníky jednotlivých fragmentů, například samostatných řádků řádkového prvku. Souřadnice jsou vztažené k výřezu a zohledňují transformace CSS. Element.scrollIntoView({ block: "nearest", behavior: "instant" }) posouvá kontejnery tak, aby prvek zobrazil. Čtení geometrie může vynutit výpočet rozvržení; tato čtení seskupte před zápisy stylů.

Jde o API prostředí prohlížeče, nikoli samotného ECMAScriptu; Node 24 nedokládá jeho dostupnost. Zdroj DOM definuje strukturu a atributy, nikoli algoritmy geometrie a posouvání z CSSOM View. Minimální verze prohlížečů nejsou uvedeny; požadované metody ověřte v cílovém prostředí. Příklad záměrně neprovádí měření rozvržení.

Příklady

(() => {
  const box = document.createElement("div");
  const first = document.createElement("span");
  const last = document.createElement("span");
  box.replaceChildren(first, "text", last);
  box.toggleAttribute("data-ready", true);

  console.log(box.children.length);
  console.log(first.parentElement === box);
  console.log(first.nextElementSibling === last);
  console.log(last.previousElementSibling === first);
  console.log(box.hasAttribute("data-ready"));
  console.log(box.toggleAttribute("data-ready", false));
  box.replaceChildren("done");
  console.log(box.children.length, box.textContent);
})();

Výsledek

2
true
true
true
true
false
0 done

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje