CKTIS / JavaScript
Element — struktura DOM, geometrija in pomikanje
Element predstavlja element DOM, ne poljubnega vozlišča. Omogoča navigacijo, atribute in zamenjavo vsebine; brskalniki ponujajo tudi meritve postavitve in pomikanje. Razlikujte strukturo drevesa, mere odjemalskega območja in pravokotnike glede na vidno polje.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
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 predstavlja element DOM. Element.children je živa zbirka neposrednih otrok, ki so elementi; besedilo in komentarje izpusti. Element.parentElement, Element.previousElementSibling in Element.nextElementSibling vrnejo element ali null. Element.tagName poda kvalificirano ime; imena elementov HTML so v dokumentih HTML zapisana z velikimi črkami.
Element.hasAttribute(name) preveri prisotnost atributa. Element.toggleAttribute(name, force) s true vsili prisotnost, s false pa odsotnost; brez force stanje preklopi. Vrne končno prisotnost. Element.replaceChildren(...nodesOrStrings) zamenja vse otroke; nizi postanejo besedilo, ne HTML. Brez argumentov odstrani vse otroke.
Pri tipičnem blokovnem elementu Element.clientWidth in Element.clientHeight podata notranjo širino in višino z notranjim odmikom, vendar brez robov in prostora, ki ga zasedajo drsniki. Pri običajnem vrstičnem elementu span obe lastnosti vrneta 0, tudi če ima notranji odmik in vidno vsebino. V standardnem načinu pri korenskem elementu vrneta mere vidnega polja brez drsnikov, ne pa mer njegovega lastnega polja z notranjim odmikom. Element.clientLeft in Element.clientTop podata odmik odjemalskega območja od roba; lahko vključujeta drsnik. Element.scrollHeight vključuje tudi vsebino, ki navpično sega izven vidnega območja. Te meritve so cela števila. Zapisljivi Element.scrollTop podaja navpični odmik pomikanja in je lahko ulomljen ali negativen pri obrnjenih postavitvah.
Element.getBoundingClientRect() vrne omejujoči pravokotnik; Element.getClientRects() vrne pravokotnike fragmentov, na primer posameznih vrstic vrstičnega elementa. Koordinate so glede na vidno polje in upoštevajo transformacije CSS. Element.scrollIntoView({ block: "nearest", behavior: "instant" }) pomakne vsebnike, da prikaže element. Branje geometrije lahko prisili izračun postavitve; ta branja združite pred zapisovanjem slogov.
To je API okolja brskalnika, ne samo ECMAScript; Node 24 ne dokazuje njegove razpoložljivosti. Vir DOM določa strukturo in atribute, ne pa algoritmov za geometrijo in pomikanje CSSOM View. Najnižje različice brskalnikov niso navedene; zahtevane metode preverite v ciljnem okolju. Primer se namenoma izogne meritvam postavitve.
Primeri
(() => {
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);
})();Rezultat
2 true true true true false 0 done
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.