IntersectionObserver.rootMargin

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 propriété rootMargin en lecture seule de l'interface IntersectionObserver est une chaîne de caractères avec une syntaxe similaire à celle de la propriété CSS margin. Chaque côté de la zone rectangulaire représentée par rootMargin est ajouté au côté correspondant du root dans le bounding box de l'élément avant que le test d'intersection soit effectué. Cela permet, par exemple, d'ajuster les limites vers l'extérieur afin que l'élément cible soit considéré comme entièrement visible même si un certain nombre de pixels en largeur ou en hauteur sont rognés, ou encore pour traiter la cible comme partiellement masquée si une bordure est trop proche de celle du bounding box de l'élément racine.

Voir L'élément racine et sa marge externe in Intersection Observer API pour une explication plus approfondie à propos de la marge externe de l'élément racine et comment cela fonctionne avec le bounding box de ce même élément.

Syntaxe

var marginString = IntersectionObserver.rootMargin;

Valeur

Une chaîne de caractères, formatée d'une manière similaire à la valeur de la propriété CSS margin, contenant les décalages pour un ou plusieurs côtés du bounding box de l'élément racine. Ces décalages sont ajoutés aux valeurs correspondantes du bounding box de l'élément racine avant l'intersection entre la zone rectangulaire résultante la zone couverte par l'élément cible.

La chaîne de caractères renvoyée par cette propriété peut ne pas correspondre à celle spécifiée lors de l'initialisation de l'IntersectionObserver. Le navigateur a la possibilté de modifier la valeur.

Si rootMargin n'est pas spécifiée à l'initialisation de l'objet, sa valeur par défaut vaudra "0px 0px 0px 0px", signifiant que l'intersection sera calculée entre les limites non modifiées de l'élément racine et celles de l'élément cible. L'élément racine et sa marge externe in Intersection Observer API décrit avec plus de détails comment rootMargin est utilisée.

Spécifications

Spécification Statut Commentaire
Intersection Observer
La définition de 'IntersectionObserver.rootMargin' dans cette spécification.
Version de travail Définition initiale

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung Internet
Support simple
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 ? Safari ? WebView Android Support complet 51Chrome Android Support complet 51Edge Mobile Support complet OuiFirefox 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é.

Étiquettes et contributeurs liés au document

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