blob: f4f90ae38bc0b71ca2bcd5d8bb878154c2d30758 (
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
|
---
title: document.getElementsByName()
slug: Web/API/Document/getElementsByName
tags:
- API
- DOM
- Document
- HTML
- Méthodes
translation_of: Web/API/Document/getElementsByName
---
{{ ApiRef("DOM") }}
Renvoie une liste des éléments portant un {{domxref("element.name","name")}} donné dans le document (X)HTML.
## Syntaxe
elements = document.getElementsByName(name)
- `elements` est une collection de {{domxref("NodeList")}}
- `name` est la valeur de l'attribut `name` des éléments.
## Exemple
```html
<!DOCTYPE html>
<html lang="en">
<head>
...
</head>
<body>
<form name="up"><input type="text"></form>
<div name="down"><input type="text"></div>
<script>
var up_forms = document.getElementsByName("up");
console.log(up_forms[0].tagName); // retourne "FORM"
</script>
</body>
</html>
```
## Notes
L'attribut [`name`](/fr/docs/Web/API/Element/name) est uniquement applicable aux documents (X) HTML. La méthode renvoie une collection {{domxref("NodeList")}} en cours qui contient tous les éléments avec une valeur donnée pour l'attribut name, tels que {{htmlelement("meta")}} ou {{htmlelement("object")}} ou même si le nom est placé sur des éléments qui ne supportent pas du tout un attribut `name`.
La méthode **getElementsByName** fonctionne différemment dans différents navigateurs. Dans IE <10, la méthode getElementsByName () renvoie également les éléments qui ont un attribut id avec la valeur spécifiée. Vous devriez donc faire attention à ne pas utiliser la même chaîne pour le nom et l'identifiant.
## Spécifications
- [DOM Level 2 HTML : getElementsByName](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-71555259) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-html/html.html#ID-71555259) (non normative)
- [HTML5 : getElementsByName](http://www.whatwg.org/html/#dom-document-getelementsbyname)
| Spécification | Statut | Commentaire |
| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------- |
| {{SpecName('HTML WHATWG', '#dom-document-getelementsbyname', "Document.getElementsByName()")}} | {{ Spec2('HTML WHATWG') }} | |
| {{SpecName("DOM2 HTML", "html.html#ID-71555259", "Document.getElementsByName()")}} | {{Spec2("DOM2 HTML")}} | Définition initiale |
## Voir aussi
- {{domxref("document.getElementById()")}} pour retourner une référence à un élément par son ID
- {{domxref("document.getElementsByTagName()")}} pour renvoyer les références sur les éléments avec la balise de nom donnée
- {{domxref("document.querySelector()")}} pour des sélecteurs par des requêtes comme `'div.myclass'`
|
