CKTIS / JavaScript
Element — структура на DOM, геометрия и превъртане
Element представлява елемент от DOM, а не произволен възел. Предоставя навигация, атрибути и замяна на съдържание; браузърите предлагат и измервания на оформлението и превъртане. Разграничавайте структурата на дървото, размерите на клиентската област и правоъгълниците спрямо прозореца за визуализация.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
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 представлява елемент от DOM. Element.children е жива колекция от преките деца, които са елементи; текстът и коментарите не се включват. Element.parentElement, Element.previousElementSibling и Element.nextElementSibling връщат елемент или null. Element.tagName дава квалифицираното име; имената на HTML елементите в HTML документи се изписват с главни букви.
Element.hasAttribute(name) проверява дали даден атрибут присъства. Element.toggleAttribute(name, force) налага присъствие при true и отсъствие при false; без force превключва състоянието. Връща крайното състояние на присъствие. Element.replaceChildren(...nodesOrStrings) заменя всички деца; низовете се третират като текст, а не като HTML. Без аргументи премахва всички деца.
За типичен блоков елемент Element.clientWidth и Element.clientHeight дават вътрешната ширина и височина, включително вътрешните отстъпи, но без рамките и пространството, заето от лентите за превъртане. При обикновен редови елемент span и двете свойства връщат 0, дори ако елементът има вътрешни отстъпи и видимо съдържание. В стандартен режим за кореновия елемент те връщат размерите на прозореца за визуализация без лентите за превъртане, а не размерите на собствената му кутия, включваща вътрешните отстъпи. Element.clientLeft и Element.clientTop дават отместването на клиентската област спрямо ръба на рамката; може да включват лента за превъртане. Element.scrollHeight включва съдържанието, което се простира вертикално извън видимата област. Тези измервания са цели числа. Записваемият Element.scrollTop дава вертикалното отместване при превъртане и може да е дробно или отрицателно при обърнати оформления.
Element.getBoundingClientRect() връща ограждащ правоъгълник; Element.getClientRects() връща правоъгълниците на фрагментите, например на отделните редове на вграден елемент. Координатите са спрямо прозореца за визуализация и отчитат CSS трансформациите. Element.scrollIntoView({ block: "nearest", behavior: "instant" }) превърта контейнерите, за да покаже елемента. Четенето на геометрията може да наложи изчисляване на оформлението; групирайте тези четения преди записите на стилове.
Това е API на средата на браузъра, а не само на ECMAScript; Node 24 не доказва наличността му. Източникът DOM дефинира структурата и атрибутите, но не алгоритмите за геометрия и превъртане на CSSOM View. Не са посочени минимални версии на браузърите; проверете необходимите методи в целевата среда. Примерът умишлено не измерва оформлението.
Примери
(() => {
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);
})();Резултат
2 true true true true false 0 done
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.