files/fr/web/api/document/elementsfrompoint/index.html


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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

---
title: DocumentOrShadowRoot.elementsFromPoint()
slug: Web/API/Document/elementsFromPoint
tags:
  - API
  - Document
  - DocumentOrShadowRoot
  - Méthode
  - Reference
  - ShadowRoot
  - elementsFromPoint
  - elementsFromPoint()
  - shadow dom
translation_of: Web/API/DocumentOrShadowRoot/elementsFromPoint
original_slug: Web/API/DocumentOrShadowRoot/elementsFromPoint
---
<div>{{APIRef("DOM")}}{{SeeCompatTable}}</div>

<p><span class="seoSummary">La propriété <strong><code>elementsFromPoint()</code></strong> de l'interface {{domxref("DocumentOrShadowRoot")}}  renvoie un tableau (<em>array</em>) de tous les éléments présents sous le point fourni en paramètre (relatif au <em>viewport</em>).</span></p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="syntaxbox">var elements = document.elementsFromPoint(x, y);</pre>

<h3 id="Paramètres">Paramètres</h3>

<dl>
 <dt>x</dt>
 <dd>L'abscisse du point (coordonnée horizontale).</dd>
 <dt>y</dt>
 <dd>L'ordonnée du point (coordonnée verticale).</dd>
</dl>

<h3 id="Valeur_de_retour">Valeur de retour</h3>

<p>Un tableau (<em>array</em>) d'objets {{domxref('element')}} représentants les éléments du DOM concernés.</p>

<h2 id="Example" name="Example">Exemples</h2>

<h3 id="HTML">HTML</h3>

<pre class="brush: html">&lt;div&gt;
  &lt;p&gt;Du texte&lt;/p&gt;
&lt;/div&gt;
&lt;p&gt;Éléments au point 30, 20:&lt;/p&gt;
&lt;div id="output"&gt;&lt;/div&gt;
</pre>

<h3 id="JavaScript">JavaScript</h3>

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

<h3 id="Résultat">Résultat</h3>

<p>{{EmbedLiveSample('Example', '420', '120')}}</p>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">État</th>
   <th scope="col">Commentaires</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Shadow DOM','#extensions-to-the-documentorshadowroot-mixin','DocumentOrShadowRoot')}}</td>
   <td>{{Spec2('Shadow DOM')}}</td>
   <td>Définition initiale</td>
  </tr>
  <tr>
   <td>{{SpecName('CSSOM View', '#dom-document-elementsfrompoint', 'Document')}}</td>
   <td>{{Spec2('CSSOM View')}}</td>
   <td>Précise l'ordre selon lequel les éléments sont peints.</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<p>{{Compat("api.DocumentOrShadowRoot.elementsFromPoint")}}</p>

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li>{{DOMxRef("DocumentOrShadowRoot.elementFromPoint()")}}</li>
 <li>{{DOMxRef("DocumentOrShadowRoot.msElementsFromRect()")}} {{Non-standard_Inline}}</li>
</ul>