IntersectionObserver.thresholds

Brouillon
Cette page n'est pas terminée.

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 propriété en lecture seule thresholds de l'interface IntersectionObserver retourne la liste des seuils d'intersection spécifiés lorsque l'observateur a été instancié avec IntersectionObserver(). Si un unique ratio seuil a été donné comme valeur numérique à l'instanciation de l'objet, cette valeur sera un tableau contenant uniquement cette valeur.

Voir Thresholds in Intersection Observer API pour apprendre comment fonctionnent les seuils d'intersection.

Syntaxe

let thresholds = IntersectionObserver.thresholds;

Valeur

Un tableau de seuils d'intersection, originellement spécifié au moyen de la propriété threshold à l'instanciation d'un observateur. Si un unique observateur a été spécifié, sans être donné dans un tableau (valeur numérique), cette valeur se traduite comme un tableau d'un élément la contenant. Quelque fut l'ordre de votre tableau original de threshold, il sera trié par ordre croissant.

Si aucune option threshold n'est donnée lorsque IntersectionObserver() est utilisé pour instantier l'observateur, la valeur de thresholds est par défaut définie à [0].

Attention! Bien que l'objet d'options que vous pouvez spécifier lorsque vous créez un IntersectionObserver a un champ nommé threshold, cette propriété-ci s'appelle thresholds. Cela peut porter à confusion. Si vous utilisez thresholds par erreur comme nom du champ votre objet d'options, le tableau de thresholds va se retrouver égal à [0.0], ce qui n'est probablement pas ce à quoi vous vous attendiez. Le déboguage n'en sera que plus chaotique.

Exemple

// Instanciation d'un observateur, c'est l'objet d'options qui contient le tableau des seuils (propriété threshold)
observateur = new IntersectionObserver(fonctionRappel, optionsObservateur)

Puis faire simplement :

observateur.thresholds

Pour afficher la liste des seuils fournie à l'initialisation.

Spécifications

Specification Status Comment
Intersection Observer
La définition de 'IntersectionObserver.thresholds' dans cette spécification.
Version de travail Initial definition

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
thresholds
Expérimentale
Chrome Support complet 51Edge Support complet 15Firefox Support complet 55
Support complet 55
Aucun support 53 — 55
Désactivée
Désactivée From version 53 until version 55 (exclusive): this feature is behind the dom.IntersectionObserver.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Aucun support NonOpera Support complet OuiSafari Support complet 12.1WebView Android Support complet 51Chrome Android Support complet 51Edge Mobile Support complet OuiFirefox Android ? Opera Android ? Safari iOS Support complet 12.2Samsung 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é.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : mdnwebdocs-bot, JNa0
Dernière mise à jour par : mdnwebdocs-bot,