KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Element — DOM-structuur, geometrie en scrollen

Element vertegenwoordigt een DOM-element, niet zomaar een willekeurige node. Het biedt navigatie, attributen en het vervangen van inhoud; browsers bieden ook lay-outmetingen en scrollen. Houd de boomstructuur, de afmetingen van het clientgebied en viewportrelatieve rechthoeken uit elkaar.

Versie: 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 vertegenwoordigt een DOM-element. Element.children is een live collectie van directe kinderen die elementen zijn; tekst en opmerkingen worden uitgesloten. Element.parentElement, Element.previousElementSibling en Element.nextElementSibling geven een element of null terug. Element.tagName geeft de gekwalificeerde naam; HTML-elementnamen in HTML-documenten worden in hoofdletters geschreven.

Element.hasAttribute(name) controleert of een attribuut aanwezig is. Element.toggleAttribute(name, force) dwingt aanwezigheid af met true en afwezigheid met false; zonder force wordt de toestand omgeschakeld. De methode geeft de uiteindelijke aanwezigheid terug. Element.replaceChildren(...nodesOrStrings) vervangt alle kinderen; tekenreeksen worden tekst, geen HTML. Zonder argumenten worden alle kinderen verwijderd.

Voor een typisch blokelement geven Element.clientWidth en Element.clientHeight de binnenbreedte en -hoogte inclusief padding, maar zonder randen en de ruimte die schuifbalken innemen. Voor een gewone inline span geven beide eigenschappen 0 terug, ook als het element padding en zichtbare inhoud heeft. In de standaardmodus geven ze voor het hoofdelement de afmetingen van de viewport zonder schuifbalken terug, niet die van de eigen paddingbox. Element.clientLeft en Element.clientTop geven de afstand van het clientgebied tot de rand; ze kunnen een schuifbalk omvatten. Element.scrollHeight omvat inhoud die verticaal buiten het zichtbare gebied valt. Deze metingen zijn gehele getallen. Het beschrijfbare Element.scrollTop geeft de verticale scrollafstand en kan een breukwaarde of in omgekeerde lay-outs een negatieve waarde hebben.

Element.getBoundingClientRect() geeft een omhullende rechthoek terug; Element.getClientRects() geeft rechthoeken van fragmenten terug, bijvoorbeeld voor de afzonderlijke regels van een inline-element. De coördinaten zijn viewportrelatief en houden rekening met CSS-transformaties. Element.scrollIntoView({ block: "nearest", behavior: "instant" }) scrollt containers om het element zichtbaar te maken. Geometriemetingen kunnen een lay-outberekening afdwingen; groepeer deze leesbewerkingen vóór schrijfbewerkingen naar stijlen.

Dit is een API van de browseromgeving, niet van ECMAScript alleen; Node 24 bewijst niet dat de API beschikbaar is. De DOM-bron definieert structuur en attributen, niet de geometrie- en scrollalgoritmen van CSSOM View. Er worden geen minimale browserversies genoemd; controleer de benodigde methoden in de doelomgeving. Het voorbeeld vermijdt bewust lay-outmetingen.

Voorbeelden

(() => {
  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);
})();

Resultaat

2
true
true
true
true
false
0 done

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen