aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/node/nodename/index.md
blob: ef15c51fc1cddf47f3815b12f792185e733a68aa (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
---
title: element.nodeName
slug: Web/API/Node/nodeName
tags:
  - API
  - DOM
  - Noeuds
  - Nom
  - Propriété
translation_of: Web/API/Node/nodeName
---
{{APIRef("DOM")}}

La propriété en lecture seule **`Node.nodeName`** renvoie le nom du nœud courant dans une chaîne.

Les valeurs retournées pour les différents types de noeuds sont :

| Interface                                        | Valeur nodeName                                                       |
| ------------------------------------------------ | --------------------------------------------------------------------- |
| {{domxref("Attr")}}                         | La valeur de {{domxref("Attr.name")}}                         |
| {{domxref("CDATASection")}}             | `"#cdata-section"`                                                    |
| {{domxref("Comment")}}                     | `"#comment"`                                                          |
| {{domxref("Document")}}                 | `"#document"`                                                         |
| {{domxref("DocumentFragment")}}         | `"#document-fragment"`                                                |
| {{domxref("DocumentType")}}             | La valeur de {{domxref("DocumentType.name")}}             |
| {{domxref("Element")}}                     | La valeur de {{domxref("Element.tagName")}}                 |
| {{domxref("Entity")}}                     | Le nom de l'entité                                                    |
| {{domxref("EntityReference")}}         | Le nom de la référence d'entité                                       |
| {{domxref("Notation")}}                 | Le nom de notation                                                    |
| {{domxref("ProcessingInstruction")}} | La valeur de {{domxref("ProcessingInstruction.target")}} |
| {{domxref("Text")}}                         | `"#text"`                                                             |

## Syntaxe

    var str = node.nodeName;

## Exemple

Avec le balisage suivant :

    <div id="d1">hello world</div>
    <input type="text" id="t"/>

et le script suivant :

    var div1 = document.getElementById("d1");
    var text_field = document.getElementById("t");
    text_field.value = div1.nodeName;

En XHTML (ou tout autre format XML), la valeur de `text_field` sera « div ». Cependant, en HTML, la valeur de `text_field` sera « DIV », parce que `nodeName` et `tagName` renvoient en casse majuscule sur les éléments HTML dans les DOM marqués comme des documents HTML. En lire plus [détails sur la sensibilité à la casse de nodeName dans différents navigateurs](http://ejohn.org/blog/nodename-case-sensitivity/) (en).

Notez que la propriété [`tagName`](fr/DOM/element.tagName) aurait pu être uilisée à la place, puisque `nodeName` a la même valeur que `tagName` pour un élément. Souvenez vous cependant que `nodeName` renverra `#text` pour les nœuds texte tandis que `tagName` renverra `undefined`.

## Spécification

- [DOM Level 2 Core: Node.nodeName](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-F68D095) — [traduction](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-F68D095) (non normative)
- [DOM Level 3 Core: Node.nodeName](http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-F68D095)
- [HTML 5: APIs in HTML documents](http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#apis-in-html-documents)

## Compatibilité des navigateurs

{{Compat("api.Node.nodeName")}}