CKTIS / JavaScript
IntersectionObserver : observer les intersections d’éléments
IntersectionObserver signale de façon asynchrone l’intersection géométrique entre un élément et une zone de référence. Découvrez root, rootMargin et threshold, et distinguez l’intersection de la visibilité réelle.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: 0 })IntersectionObserver est une API Web du navigateur, et non une fonctionnalité d’ECMAScript. Sa disponibilité dans Node 24 ne garantit pas sa prise en charge par le navigateur ; vérifiez l’environnement cible.
root définit la zone de référence ; la valeur par défaut null désigne la fenêtre d’affichage. rootMargin agrandit ou réduit ses limites avec 1 à 4 valeurs en pixels ou en pourcentage. Ces décalages ne s’appliquent qu’aux cibles du même domaine d’origine (same-origin-domain) et sont ignorés pour les cibles d’un autre domaine d’origine (cross-origin-domain). threshold accepte un nombre ou un tableau compris dans [0, 1] ; sa valeur par défaut est 0. La propriété en lecture seule thresholds expose les ratios de surface de la cible, triés.
Après le début de l’observation, le callback reçoit normalement une entrée initiale pour la cible, mais cette transmission n’est pas garantie. L’observation peut s’arrêter avant la création de l’entrée, et takeRecords() peut retirer l’entrée de la file d’attente avant qu’elle ne soit transmise au callback. Les entrées suivantes sont mises en file d’attente lorsqu’un seuil est franchi ou que isIntersecting change. Une intersection géométrique ne prouve pas une visibilité réelle ; des bords qui se touchent peuvent produire isIntersecting === true avec une aire d’intersection nulle.
observe(target) commence l’observation, unobserve(target) l’arrête pour une cible et disconnect() l’arrête pour toutes. L’exemple vérifie l’intersection initiale complète, puis nettoie les ressources.
Exemples
(() => {
if (!("IntersectionObserver" in window)) {
throw new Error("IntersectionObserver unavailable");
}
const root = document.createElement("div");
root.style.cssText = "position:fixed;top:0;left:0;width:100px;height:100px;overflow:hidden;padding:0;border:0;";
const target = document.createElement("div");
target.style.cssText = "width:20px;height:20px;margin:0;";
root.append(target);
document.body.append(root);
const observer = new IntersectionObserver((entries) => {
console.log(entries[0].intersectionRatio === 1);
observer.disconnect();
root.remove();
}, { root, rootMargin: "0px", threshold: [0, 1] });
observer.observe(target);
})();Résultat
true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.