DocumentOrShadowRoot.elementsFromPoint()

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é elementsFromPoint() de l'interface DocumentOrShadowRoot  renvoie un tableau (array) de tous les éléments présents sous le point fourni en paramètre (relatif au viewport).

Syntaxe

var elements = document.elementsFromPoint(x, y);

Paramètres

x
L'abscisse du point (coordonnée horizontale).
y
L'ordonnée du point (coordonnée verticale).

Valeur de retour

Un tableau (array) d'objets element représentants les éléments du DOM concernés.

Exemples

HTML

<div>
  <p>Du texte</p>
</div>
<p>Éléments au point 30, 20:</p>
<div id="output"></div>

JavaScript

var output = document.getElementById("output");
if (document.elementsFromPoint) {
  var elements = document.elementsFromPoint(30, 20);
  for(var i = 0; i < elements.length; i++) {
    output.textContent += elements[i].localName;
    if (i < elements.length - 1) {
      output.textContent += " < ";
    }
  }
} else {
  output.innerHTML = "<span style=\"color: red;\">" +
     "Votre navigateur ne prend pas en charge <code>document.elementsFromPoint()</code>" +
     "</span>";
}

Résultat

Spécifications

Spécification État Commentaires
Shadow DOM
La définition de 'DocumentOrShadowRoot' dans cette spécification.
Obsolete Définition initiale
CSS Object Model (CSSOM) View Module
La définition de 'Document' dans cette spécification.
Version de travail Précise l'ordre selon lequel les éléments sont peints.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
elementsFromPoint
Expérimentale
Chrome Support complet 53
Notes
Support complet 53
Notes
Notes Before Chrome 66, this method returned null when the element was a child of a host node. See issue 759947.
Edge Support complet 12
Notes Autre nom
Support complet 12
Notes Autre nom
Notes Returns a NodeList instead of an array. See the MSDN documentation. Returns null when the point provided has no elements beneath it (e.g., when given a point outside the document).
Autre nom Cette fonctionnalité utilise le nom non-standard : msElementsFromPoint
Firefox Support complet 63IE Support complet 10
Notes Autre nom
Support complet 10
Notes Autre nom
Notes Returns a NodeList instead of an array. See the MSDN documentation. Returns null when the point provided has no elements beneath it (e.g., when given a point outside the document).
Autre nom Cette fonctionnalité utilise le nom non-standard : msElementsFromPoint
Opera Support complet 40Safari Support complet 12WebView Android Support complet 53
Notes
Support complet 53
Notes
Notes Before WebView 66, this method returned null when the element was a child of a host node. See issue 759947.
Chrome Android Support complet 53
Notes
Support complet 53
Notes
Notes Before Chrome 66, this method returned null when the element was a child of a host node. See issue 759947.
Firefox Android Support complet 63Opera Android Support complet 41Safari iOS Support complet 12Samsung Internet Android Support complet 6.0
Notes
Support complet 6.0
Notes
Notes Before Samsung Internet 9.0, this method returned null when the element was a child of a host node. See issue 759947.

Légende

Support complet  
Support complet
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.
Voir les notes d'implémentation.
Voir les notes d'implémentation.
Cette fonctionnalité utilise un nom non-standard.
Cette fonctionnalité utilise un nom non-standard.

Voir aussi