Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

IntersectionObserverEntry : état d’intersection et élément observé

`isIntersecting` indique si l’élément intersecte la zone de référence au moment de la mesure, tandis que `target` identifie l’élément observé décrit par l’entrée.

Version : Current web platform; runtime support varies

Syntaxe

entry.isIntersecting // boolean
entry.target         // Element

Parmi les propriétés d’instance en lecture seule de IntersectionObserverEntry figurent entry.isIntersecting et entry.target. entry.isIntersecting est un booléen (true si l’élément intersecte la zone de référence, false sinon). entry.target est le même objet DOM de type Element que celui passé à observe(), et non la racine ni un sélecteur. La référence peut être, par exemple, un conteneur défilant. Lorsque root vaut null (la valeur par défaut), la référence est la zone d’affichage (viewport) du document de premier niveau. Pour un élément situé dans une iframe, le calcul de intersectionRect tient aussi compte du découpage aux limites de la zone d’affichage du cadre.

Une entrée consigne une mesure et ne se met pas à jour en direct. Après observe(), le premier résultat arrive de manière asynchrone, même si l’élément n’a pas bougé. Les entrées suivantes peuvent signaler un changement d’état d’intersection ou le franchissement d’un seuil configuré pour le taux d’intersection. true ne signifie donc pas à lui seul que l’élément vient d’entrer dans la zone. Traitez tout le tableau entries : un seul appel de la fonction de rappel peut fournir plusieurs entrées.

Un contact par le bord peut compter comme une intersection même si intersectionRatio vaut 0. Pour vérifier que l’intersection géométrique a une aire positive, exigez à la fois entry.intersectionRect.width > 0 et entry.intersectionRect.height > 0. Cela ne prouve pas que l’utilisateur voit l’élément : un autre élément peut le masquer.

Cette API appartient à la plateforme web, pas à ECMAScript 2024. Vérifiez que l’environnement cible fournit IntersectionObserver. Utilisez unobserve(element) pour arrêter d’observer un élément, ou disconnect() pour arrêter d’observer tous les éléments de cet observateur.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IntersectionObserverEntry example</title>
</head>
<body>
<script>
(() => {
  const root = document.createElement('div');
  root.style.cssText = 'position:fixed;top:0;left:0;width:120px;height:60px;overflow:hidden';

  const makeTarget = (left) => {
    const element = document.createElement('div');
    element.style.cssText = `position:absolute;top:8px;left:${left}px;width:16px;height:16px`;
    root.append(element);
    return element;
  };

  const inside = makeTarget(8);
  const outside = makeTarget(150);
  document.body.append(root);

  const states = new Map();
  const observer = new IntersectionObserver((entries, currentObserver) => {
    for (const entry of entries) {
      states.set(entry.target, entry.isIntersecting);
    }
    if (!states.has(inside) || !states.has(outside)) return;

    currentObserver.disconnect();
    root.remove();
    console.log(`inside: ${states.get(inside)}\noutside: ${states.get(outside)}`);
  }, { root });

  observer.observe(inside);
  observer.observe(outside);
})();
</script>
</body>
</html>

Résultat

inside: true
outside: false

Enregistrez le code dans un fichier HTML, ouvrez-le dans un navigateur et consultez le résultat dans la console de développement. Le premier élément est dans le conteneur de référence, le second entièrement à l’extérieur. Le code attend les deux entrées initiales, affiche les états dans un ordre fixe, puis nettoie les ressources utilisées.

Leçons associées

  • JavaScript · Leçon 30 · Intermédiaire · Version : 3

Sources