CKTIS / JavaScript
Element — struttura DOM, geometria e scorrimento
Element rappresenta un elemento DOM, non un nodo qualsiasi. Offre navigazione, attributi e sostituzione dei contenuti; nei browser espone anche misure del layout e scorrimento. Distingui la struttura dell’albero, le dimensioni dell’area client e i rettangoli relativi alla finestra.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
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 rappresenta un elemento DOM. Element.children è una raccolta viva dei figli diretti che sono elementi; esclude testo e commenti. Element.parentElement, Element.previousElementSibling e Element.nextElementSibling restituiscono un elemento oppure null. Element.tagName fornisce il nome qualificato; nei documenti HTML i nomi degli elementi HTML sono scritti in maiuscolo.
Element.hasAttribute(name) verifica la presenza di un attributo. Element.toggleAttribute(name, force) ne forza la presenza con true e l’assenza con false; senza force, alterna lo stato. Restituisce la presenza finale. Element.replaceChildren(...nodesOrStrings) sostituisce tutti i figli; le stringhe diventano testo, non HTML. Senza argomenti rimuove tutti i figli.
Per un tipico elemento a blocco, Element.clientWidth e Element.clientHeight indicano la larghezza e l’altezza interne, compresa la spaziatura interna ma non i bordi né lo spazio occupato dalle barre di scorrimento. Per un normale span inline, entrambe le proprietà restituiscono 0 anche se l’elemento ha spaziatura interna e contenuto visibile. In modalità standard, per l’elemento radice restituiscono le dimensioni del viewport, escluse le barre di scorrimento, e non quelle del suo riquadro di padding. Element.clientLeft e Element.clientTop indicano lo scostamento dell’area client dal bordo; possono includere una barra di scorrimento. Element.scrollHeight comprende i contenuti che eccedono verticalmente. Queste misure sono numeri interi. Element.scrollTop, scrivibile, indica lo scostamento verticale di scorrimento e può essere frazionario o negativo nei layout invertiti.
Element.getBoundingClientRect() restituisce un rettangolo circoscritto; Element.getClientRects() restituisce i rettangoli dei frammenti, per esempio delle singole righe di un elemento inline. Le coordinate sono relative alla finestra e tengono conto delle trasformazioni CSS. Element.scrollIntoView({ block: "nearest", behavior: "instant" }) fa scorrere i contenitori per rendere visibile l’elemento. Leggere la geometria può forzare il calcolo del layout; raggruppa queste letture prima delle scritture degli stili.
Questa è un’API dell’ambiente browser, non di ECMAScript da solo; Node 24 non ne dimostra la disponibilità. La fonte DOM definisce struttura e attributi, non gli algoritmi di geometria e scorrimento di CSSOM View. Non sono indicate versioni minime dei browser; verifica i metodi richiesti nell’ambiente di destinazione. L’esempio evita intenzionalmente le misurazioni del layout.
Esempi
(() => {
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);
})();Risultato
2 true true true true false 0 done
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.