CKTIS / JavaScript
Défiler et remplacer les enfants d’un élément : scrollTop, scrollHeight et replaceChildren()
Lisez et réglez la position de défilement, distinguez la hauteur totale de la zone défilable de sa hauteur intérieure visible et remplacez les nœuds enfants sans analyser les chaînes comme du HTML.
Version : Current web platform; runtime support varies
Syntaxe
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 est le décalage vertical depuis l’origine du défilement, en pixels CSS. Cette propriété est accessible en lecture et en écriture et sa valeur peut être fractionnaire. Une affectation demande une position absolue, non un déplacement relatif, avec le comportement auto. Avec flex-direction: column-reverse, la valeur peut être négative ; l’effet de rebond de Safari peut la faire sortir temporairement de la plage habituelle.
scrollHeight est la hauteur entière, en lecture seule, de toute la zone de défilement, y compris sa partie masquée. Elle comprend le remplissage (padding) et peut inclure les pseudo-éléments, mais exclut la bordure, la marge externe et la barre de défilement horizontale. clientHeight mesure la hauteur intérieure visible. Sans débordement vertical, les deux hauteurs sont égales.
Dans un conteneur qui défile normalement vers le bas, el.scrollHeight - el.clientHeight donne une approximation de scrollTop en bas. Vérifiez cette position avec Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1 plutôt qu’avec === : les hauteurs sont arrondies, mais le décalage peut être fractionnaire. N’utilisez pas ce test tel quel avec une disposition inversée ni pendant un rebond.
replaceChildren() remplace tous les nœuds enfants directs, pas l’élément lui-même. La méthode accepte un nombre quelconque de Node ou de chaînes, déplace les nœuds existants au lieu de les cloner et transforme les chaînes en nœuds Text sans analyser de HTML. Sans argument, elle vide l’élément. Elle renvoie undefined ; une insertion qui enfreint la hiérarchie de l’arbre peut lever HierarchyRequestError (une DOMException).
Remplacez d’abord le contenu, puis mesurez la nouvelle disposition et réglez le défilement, car sa plage peut changer. ECMAScript 2024 est la version de référence du langage JavaScript, pas une version de ces API de la plateforme web. La norme DOM définit replaceChildren() et CSSOM View définit scrollTop, scrollHeight et clientHeight. La prise en charge dépend de la version du navigateur ; les mesures nécessitent un moteur de mise en page.
Exemples
<!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>Résultat
160 100 true <b>Done</b> | 0 0
Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console de développement. Les hauteurs 160 et 100 donnent une plage de défilement de 60 pixels CSS. `true` indique que la position est en bas à la tolérance près. Le balisage s’affiche comme du texte et le dernier `0` indique qu’il ne reste aucun nœud enfant.
Leçons associées
- JavaScript · Leçon 42 · Avancé · Version : 4