aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/document/elementfrompoint/index.md
blob: cbd5891099bd78cc16de75358fb2e7f0aa7486d6 (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
---
title: document.elementFromPoint
slug: Web/API/Document/elementFromPoint
tags:
  - Référence_du_DOM_Gecko
translation_of: Web/API/DocumentOrShadowRoot/elementFromPoint
translation_of_original: Web/API/Document/elementFromPoint
original_slug: Web/API/DocumentOrShadowRoot/elementFromPoint
---
{{ ApiRef() }}

### Résumé

Renvoie l'élément visible au point donné, spécifié relativement au point supérieur gauche visible dans le document.

### Syntaxe

    element = document.elementFromPoint(x,y);

where

- `element` est un objet [element](fr/DOM/element).
- `x` et `y` spécifient les coordonnées à vérifier.

### Exemple

```html
<html>
<head>
<title>Exemple d'utilisation d'elementFromPoint</title>

<script type="text/javascript">

function changeColor(newColor)
{
 elem = document.elementFromPoint(2, 2);
 elem.style.color = newColor;
}
</script>
</head>

<body>
<p id="para1">Un peu de texte ici</p>
<button onclick="changeColor('blue');">bleu</button>
<button onclick="changeColor('red');">rouge</button>
</body>
</html>
```

### Notes

Si l'élément au point spécifié appartient à un autre document (par exemple, les sous-document d'un iframe), l'élément dans le DOM du document appelant (l'iframe lui-même) est renvoyé. Si l'élément au point donné est anonyme ou du contenu généré par XBL, comme la barre de défilement d'une boîte de texte, le premier élément parent non anonyme (par exemple, la boîte de texte) est renvoyé.

Si le point spécifié est en dehors de la portion visible du document ou que l'une ou l'autre des coordonnées est négative, le résultat est `NULL`.

{{ Note("Les appelants qui sont des documents XUL devraient attendre que l\'évènement <code>onload</code> se soit déclenché avant d\'appeler cette méthode.") }}

### Spécification

- Spécification préliminaire : [`elementFromPoint`](http://dev.w3.org/csswg/cssom/#documentlayout-elementfrompoint)