aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/document/elementsfrompoint/index.md
blob: e275e5780dd0556ffff844d37d246c546dd9058d (plain)
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
---
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
---
{{APIRef("DOM")}}{{SeeCompatTable}}

La propriété **`elementsFromPoint()`** de l'interface {{domxref("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 {{domxref('element')}} représentants les éléments du DOM concernés.

## Exemples

### HTML

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

### JavaScript

```js
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

{{EmbedLiveSample('Example', '420', '120')}}

## Spécifications

| Spécification                                                                                                                    | État                             | Commentaires                                           |
| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------------ |
| {{SpecName('Shadow DOM','#extensions-to-the-documentorshadowroot-mixin','DocumentOrShadowRoot')}} | {{Spec2('Shadow DOM')}} | Définition initiale                                    |
| {{SpecName('CSSOM View', '#dom-document-elementsfrompoint', 'Document')}}                                 | {{Spec2('CSSOM View')}} | Précise l'ordre selon lequel les éléments sont peints. |

## Compatibilité des navigateurs

{{Compat("api.DocumentOrShadowRoot.elementsFromPoint")}}

## Voir aussi

- {{DOMxRef("DocumentOrShadowRoot.elementFromPoint()")}}
- {{DOMxRef("DocumentOrShadowRoot.msElementsFromRect()")}} {{Non-standard_Inline}}