Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.
Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
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 a 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 un 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
IntersectionObserver.observe(cible);
Paramètres
cible
- Un
element
dont la visibilité dans la racine est à suivre. Cet élément doit nécessairement être 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
.
Exemples
// Créer l'observateur let observateur = new IntersectionObserver(fonctionRappel, optionsObservateur);
Faire observer un élément par l'observateur :
observateur.observe(cible);
Spécifications
Spécification | Statut | Commentaire |
---|---|---|
Intersection Observer La définition de 'IntersectionObserver.observe()' dans cette spécification. |
Version de travail | Définition initiale. |
Compatibilité des navigateurs
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Ordinateur | Mobile | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Support simple | Chrome Support complet 51 | Edge Support complet 15 | Firefox
Support complet
55
| IE Aucun support Non | Opera ? | Safari ? | WebView Android Support complet 51 | Chrome Android Support complet 51 | Edge Mobile Support complet Oui | Firefox Android ? | Opera Android ? | Safari iOS ? | Samsung Internet Android Support complet 5.0 |
Légende
- Support complet
- Support complet
- Aucun support
- Aucun support
- Compatibilité inconnue
- Compatibilité inconnue
- Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
- Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
- Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
- Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.