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.
BCD tables only load in the browser
Spécification | Statut | Commentaire |
---|---|---|
Intersection Observer La définition de 'IntersectionObserver.rootMargin' dans cette spécification. |
Version de travail | Définition initiale |
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.