CKTIS / JavaScript
Element — struktura DOM, geometria i przewijanie
Element reprezentuje element DOM, a nie dowolny węzeł. Udostępnia nawigację, atrybuty i wymianę zawartości; w przeglądarce także pomiary układu oraz przewijanie. Rozróżniaj strukturę drzewa, rozmiary obszaru klienta i prostokąty względem obszaru widoku.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
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 reprezentuje element DOM. Element.children to żywa kolekcja bezpośrednich dzieci będących elementami; pomija tekst i komentarze. Element.parentElement, Element.previousElementSibling i Element.nextElementSibling zwracają element albo null. Element.tagName podaje nazwę kwalifikowaną; w dokumentach HTML nazwy elementów HTML są zapisywane wielkimi literami.
Element.hasAttribute(name) sprawdza obecność atrybutu. Element.toggleAttribute(name, force) wymusza obecność dla true, brak dla false; bez force przełącza stan. Zwraca końcową obecność. Element.replaceChildren(...nodesOrStrings) zastępuje wszystkie dzieci; ciągi stają się tekstem, nie kodem HTML. Bez argumentów usuwa dzieci.
Dla typowego elementu blokowego Element.clientWidth i Element.clientHeight podają wewnętrzną szerokość i wysokość wraz z paddingiem, bez obramowania i miejsca zajętego przez paski przewijania. Dla zwykłego liniowego elementu span obie właściwości zwracają 0, nawet jeśli element ma padding i widoczną zawartość. W trybie zgodności ze standardami dla elementu głównego dokumentu zwracają wymiary obszaru widoku bez miejsca zajętego przez paski przewijania, a nie wymiary jego własnego pola obejmującego padding. Element.clientLeft i Element.clientTop określają odsunięcie obszaru klienta od krawędzi obramowania; mogą uwzględniać pasek przewijania. Element.scrollHeight obejmuje także pionowo niewidoczną zawartość. Te pomiary są całkowitoliczbowe. Zapisywalny Element.scrollTop określa pionowe przesunięcie przewijania i może być ułamkowy, a w odwróconym układzie również ujemny.
Element.getBoundingClientRect() zwraca otaczający prostokąt, a Element.getClientRects() listę prostokątów fragmentów, np. osobnych wierszy elementu liniowego. Współrzędne są względem obszaru widoku i uwzględniają transformacje CSS. Element.scrollIntoView({ block: "nearest", behavior: "instant" }) przewija kontenery, aby pokazać element. Odczyty geometrii mogą wymusić obliczenie układu; grupuj je przed zapisami stylów.
To API środowiska przeglądarki, nie samo ECMAScript; Node 24 nie dowodzi jego dostępności. Źródło DOM definiuje strukturę i atrybuty, nie algorytmy geometrii i przewijania z CSSOM View. Nie podano minimalnych wersji przeglądarek; sprawdź wymagane metody w środowisku docelowym. Przykład celowo nie mierzy układu.
Przykłady
(() => {
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);
})();Wynik
2 true true true true false 0 done
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.