Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

IntersectionObserver.observe()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨mars 2019⁩.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

La méthode observe() de l'interface IntersectionObserver ajoute un élément à l'ensemble des éléments cibles étant observés par l'IntersectionObserver. Un observateur possède un ensemble de seuils d'intersection et une racine, mais peut observer plusieurs éléments cibles en surveillant leurs changements de visibilité indépendamment. Pour cesser d'observer un élément, il faut appeler la méthode IntersectionObserver.unobserve().

Lorsque la visibilité d'un élément cible franchit l'un des seuils d'intersection de l'observateur (tel que listé dans IntersectionObserver.thresholds, la fonction de rappel de l'observateur est executée avec comme argument un objet IntersectionObserverEntry représentant le changement d'intersection qui a été observé. À noter que cette conception permet à de multiples changements d'intersection d'éléments différents d'être traités par un unique appel à la fonction de rappel au moyen d'un tableau d'objets IntersectionObserverEntry.

Syntaxe

js
IntersectionObserver.observe(targetElement);

Paramètres

targetElement

Un élément dont on souhaite observer les changements de visibilité dans la racine. Cet élément doit nécessairement être un descendant de l'élément racine (ou contenu dans le document courant si la racine est la fenêtre du document).

Valeur de retour

undefined.

Spécifications

Specification
Intersection Observer
# dom-intersectionobserver-observe

Compatibilité des navigateurs

Voir aussi