blob: cb495920d8e4ec10afbeb5fa8e9b2aaa89c18535 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
|
---
title: IntersectionObserverEntry
slug: Web/API/IntersectionObserverEntry
tags:
- API
- Interface
- Intersection Observer
- IntersectionObserver
- IntersectionObserverEntry
translation_of: Web/API/IntersectionObserverEntry
---
{{SeeCompatTable}}{{APIRef("Intersection Observer API")}}
L'interface **`IntersectionObserverEntry`** de l'[API Intersection Observer](/en-US/docs/Web/API/Intersection_Observer_API) décrit l'intersection entre l'élément cible et son conteneur (appelé racine) à un moment spécifique de transition.
Les instances de `IntersectionObserverEntry` sont délivrées à une fonction de rappel de l'{{domxref("IntersectionObserver")}} en tant que paramètres `entries` ; autrement, ces objets ne peuvent être obtenus qu'en appelant {{domxref("IntersectionObserver.takeRecords()")}}.
## Propriétés
- {{domxref("IntersectionObserverEntry.boundingClientRect")}} {{readonlyinline}}
- : Retourne les limites de la zone couverte par l'élément cible comme {{domxref("DOMRectReadOnly")}}. Ces limites sont calculées comme décrit dans la documentation pour {{domxref("Element.getBoundingClientRect()")}}.
- {{domxref("IntersectionObserverEntry.intersectionRatio")}} {{readonlyinline}}
- : Retourne le ratio de l'`intersectionRect` au `boundingClientRect`.
- {{domxref("IntersectionObserverEntry.intersectionRect")}} {{readonlyinline}}
- : Retourne un {{domxref("DOMRectReadOnly")}} représentant la partie visible de l'élément cible.
- {{domxref("IntersectionObserverEntry.isIntersecting")}} {{ReadOnlyInline}}
- : Retourne une valeur booléenne valant `true` si l'élément cible s'entrecoupe avec la zone d'intersection de l'élément racine. S'il vaut `true`, alors `IntersectionObserverEntry` décrit une transition vers un état d'intersection ; S'il vaut `false`, alors la transition se fait d'un état d'intersection à un état de non-intersection.
- {{domxref("IntersectionObserverEntry.rootBounds")}} {{readonlyinline}}
- : Retourne un {{domxref("DOMRectReadOnly")}} pour la zone d'intersection de l'élément racine.
- {{domxref("IntersectionObserverEntry.target")}} {{ReadOnlyInline}}
- : L'{{domxref("Element")}} dont l'intersection avec la racine a changé d'état.
- {{domxref("IntersectionObserverEntry.time")}} {{readonlyinline}}
- : Un {{domxref("DOMHighResTimeStamp")}} indiquant l'instant auquel l'intersection a été enregistrée, relative au [temps originel](/en-US/docs/Web/API/DOMHighResTimeStamp#The_time_origin) de l'`IntersectionObserver`.
## Méthodes
_Cette interface n'a pas de méthode._
## Spécifications
| Spécification | Statut | Commentaire |
| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------- |
| {{SpecName('IntersectionObserver','#intersection-observer-entry','IntersectionObserverEntry')}} | {{Spec2('IntersectionObserver')}} | Définition initiale |
## Compatibilité des navigateurs
{{Compat("api.IntersectionObserverEntry")}}
|