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.