Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Scorrimento e sostituzione dei figli di un elemento: scrollTop, scrollHeight e replaceChildren()

Leggi e imposta la posizione di scorrimento, distingui l’altezza totale dell’area scorrevole dall’altezza interna visibile e sostituisci i nodi figli senza interpretare le stringhe come HTML.

Versione: Current web platform; runtime support varies

Sintassi

const offset = el.scrollTop;
el.scrollTop = y;
const contentHeight = el.scrollHeight;
const visibleHeight = el.clientHeight;
el.replaceChildren();
el.replaceChildren(node, "text");
el.replaceChildren(...items);

scrollTop è la posizione verticale rispetto all’origine dello scorrimento, in pixel CSS. È una proprietà di lettura e scrittura e può avere una parte frazionaria. Un’assegnazione richiede una posizione assoluta, non uno spostamento relativo, con il comportamento di scorrimento auto. Con flex-direction: column-reverse sono possibili valori negativi; il rimbalzo di Safari può portare temporaneamente il valore fuori dall’intervallo consueto.

scrollHeight è l’altezza intera, di sola lettura, dell’intera area scorrevole, compresa la parte non visibile. Include il padding e può includere gli pseudoelementi, ma esclude il bordo, il margine e la barra di scorrimento orizzontale. clientHeight misura l’altezza interna visibile. Se non c’è overflow verticale, le due altezze coincidono.

In un normale contenitore che scorre verso il basso, el.scrollHeight - el.clientHeight approssima il valore di scrollTop a fondo corsa. Verifica il fondo con Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1, non con ===: le altezze sono arrotondate, mentre la posizione può essere frazionaria. Non usare il test senza adattarlo a un layout invertito o durante il rimbalzo.

replaceChildren() sostituisce tutti i nodi figli diretti, non l’elemento stesso. Accetta un numero qualsiasi di oggetti Node o stringhe, sposta i nodi esistenti anziché clonarli e trasforma le stringhe in nodi Text senza interpretare l’HTML. Senza argomenti svuota l’elemento. Restituisce undefined; un inserimento che viola la gerarchia dell’albero può generare HierarchyRequestError (una DOMException).

Prima sostituisci il contenuto, poi misura il nuovo layout e imposta la posizione, perché l’intervallo di scorrimento può cambiare. ECMAScript 2024 è la versione di riferimento del linguaggio JavaScript, non una versione di queste API della piattaforma web. Lo standard DOM definisce replaceChildren(), mentre CSSOM View definisce scrollTop, scrollHeight e clientHeight. Il supporto dipende dalla versione del browser; le misure richiedono un motore di layout.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element scrolling and child replacement</title>
</head>
<body>
<script>
(() => {
  const box = document.createElement('div');
  box.style.cssText = 'width:200px;height:100px;padding:0;border:0;overflow-x:hidden;overflow-y:auto;scroll-behavior:auto';
  box.textContent = 'Old content';
  document.body.append(box);

  try {
    const row = document.createElement('div');
    row.style.height = '160px';
    box.replaceChildren(row);

    const end = box.scrollHeight - box.clientHeight;
    box.scrollTop = end;
    const atBottom = Math.abs(end - box.scrollTop) <= 1;
    console.log(`${box.scrollHeight} ${box.clientHeight} ${atBottom}`);

    box.replaceChildren('<b>Done</b>');
    console.log(`${box.textContent} | ${box.children.length}`);

    box.replaceChildren();
    console.log(box.childNodes.length);
  } finally {
    box.remove();
  }
})();
</script>
</body>
</html>

Risultato

160 100 true
<b>Done</b> | 0
0

Salva l’esempio come file HTML, aprilo in un browser e controlla la console per sviluppatori. Le altezze 160 e 100 danno un’escursione di 60 pixel CSS. `true` indica che la posizione è a fondo corsa entro la tolleranza. Il markup appare come testo letterale e lo `0` finale indica che non rimangono nodi figli.

Lezioni correlate

  • JavaScript · Lezione 42 · Avanzato · Versione: 4

Fonti