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

CKTIS / JavaScript

Element — štruktúra DOM, geometria a posúvanie

Element predstavuje prvok DOM, nie ľubovoľný uzol. Poskytuje navigáciu, atribúty a nahrádzanie obsahu; prehliadače navyše sprístupňujú merania rozloženia a posúvanie. Rozlišujte štruktúru stromu, rozmery klientskej oblasti a obdĺžniky vzhľadom na výrez.

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

Syntax

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 predstavuje prvok DOM. Element.children je živá kolekcia priamych potomkov, ktoré sú prvkami; text a komentáre vynecháva. Element.parentElement, Element.previousElementSibling a Element.nextElementSibling vracajú prvok alebo null. Element.tagName udáva kvalifikovaný názov; názvy HTML prvkov v HTML dokumentoch sa zapisujú veľkými písmenami.

Element.hasAttribute(name) kontroluje prítomnosť atribútu. Element.toggleAttribute(name, force) vynúti prítomnosť pri true a neprítomnosť pri false; bez force stav prepne. Vráti konečnú prítomnosť. Element.replaceChildren(...nodesOrStrings) nahradí všetkých potomkov; reťazce sa považujú za text, nie za HTML. Bez argumentov odstráni všetkých potomkov.

Pri typickom blokovom prvku udávajú Element.clientWidth a Element.clientHeight vnútornú šírku a výšku vrátane vnútorného odsadenia, ale bez orámovania a priestoru, ktorý zaberajú posuvníky. Pri bežnom riadkovom prvku span obe vlastnosti vracajú 0, aj keď má vnútorné odsadenie a viditeľný obsah. V štandardnom režime vracajú pri koreňovom prvku rozmery výrezu bez posuvníkov, nie rozmery jeho vlastnej oblasti ohraničenej hranou vnútorného odsadenia. Element.clientLeft a Element.clientTop udávajú posun klientskej oblasti od okraja; môžu zahŕňať posuvník. Element.scrollHeight zahŕňa aj obsah presahujúci zvisle. Tieto merania sú celé čísla. Zapisovateľný Element.scrollTop udáva zvislý posun a môže byť zlomkový alebo záporný v obrátených rozloženiach.

Element.getBoundingClientRect() vracia ohraničujúci obdĺžnik; Element.getClientRects() vracia obdĺžniky fragmentov, napríklad samostatných riadkov riadkového prvku. Súradnice sú vzhľadom na výrez a zohľadňujú transformácie CSS. Element.scrollIntoView({ block: "nearest", behavior: "instant" }) posúva kontajnery, aby prvok zobrazil. Čítanie geometrie môže vynútiť výpočet rozloženia; tieto čítania zoskupte pred zápismi štýlov.

Ide o API prostredia prehliadača, nie samotného ECMAScriptu; Node 24 nepotvrdzuje jeho dostupnosť. Zdroj DOM definuje štruktúru a atribúty, nie algoritmy geometrie a posúvania z CSSOM View. Minimálne verzie prehliadačov sa neuvádzajú; požadované metódy overte v cieľovom prostredí. Príklad zámerne neobsahuje merania rozloženia.

Prí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ýsledok

2
true
true
true
true
false
0 done

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje