База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници