blob: 5f7539d8b187b9fcb210dc5a604fe87437886fdd (
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: NamedNodeMap
slug: Web/API/NamedNodeMap
tags:
- API
- DOM
- Interface
- Reference
translation_of: Web/API/NamedNodeMap
---
{{APIRef("DOM")}}
L'interface **`NamedNodeMap`** représente une collection d'objets {{domxref("Attr")}}. Les objets de cette collection n'ont pas d'ordre particulier (contrairement à {{domxref("NodeList")}}) mais on peut y accéder grâce à un index (comme pour un tableau).
Un objet `NamedNodeMap` est _vivant_ et sera automatiquement mis à jour si des modifications sont apportées à son contenu (que cela provienne d'une source interne ou externe).
> **Note :** Bien qu'intitulée `NamedNodeMap`, cette interface ne manipule pas d'objets {{domxref("Node")}} mais des objets {{domxref("Attr")}}. Ces derniers étaient à l'origine (et le sont toujours pour certaines implémentations) une classe spécialisée de {{domxref("Node")}}.
## Propriétés
_Cette interface n'hérite d'aucune propriété._
- {{domxref("NamedNodeMap.length")}} {{ReadOnlyInline}}
- : Cette propriété renvoie le nombre d'objets contenus dans la _map_.
## Méthodes
_Cette interface n'hérite d'aucune méthode._
- {{domxref("NamedNodeMap.getNamedItem()")}}
- : Cette méthode renvoie un objet {{domxref("Attr")}} qui correspond au nom indiqué.
- {{domxref("NamedNodeMap.setNamedItem()")}}
- : Cette méthode remplace ou ajoute l'objet {{domxref("Attr")}} identifié dans la collection par le nom indiqué.
- {{domxref("NamedNodeMap.removeNamedItem()")}}
- : Cette méthode retire l'objet {{domxref("Attr")}} de la collection à partir du nom indiqué.
- {{domxref("NamedNodeMap.item()")}}
- : Cette méthode renvoie l'objet {{domxref("Attr")}} à l'index indiqué (ou `null` si l'index est supérieur ou égal au nombre de nœuds.
- {{domxref("NamedNodeMap.getNamedItemNS()")}}
- : Cette méthode renvoie un objet {{domxref("Attr")}} identifié par un espace de noms et un nom local associé.
- {{domxref("NamedNodeMap.setNamedItemNS()")}}
- : Cette méthode remplace ou ajoute un objet {{domxref("Attr")}} identifié par un espace de noms et un nom local associé.
- {{domxref("NamedNodeMap.removeNamedItemNS()")}}
- : Cette méthode retire l'objet {{domxref("Attr")}} de la collection à partir d'un espace de noms et d'un nom local associé.
## Spécifications
| Spécification | État | Commentaires |
| -------------------------------------------------------------------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------- |
| {{SpecName('DOM WHATWG', '#interface-namednodemap', 'NamedNodeMap')}} | {{Spec2('DOM WHATWG')}} | Interagit avec {{domxref("Attr")}} plutôt qu'avec {{domxref("Node")}} |
| {{SpecName('DOM3 Core', 'core.html#ID-1780488922', 'NamedNodeMap')}} | {{Spec2('DOM3 Core')}} | Aucune modification depuis {{SpecName('DOM2 Core')}} |
| {{SpecName('DOM2 Core', 'core.html#ID-1780488922', 'NamedNodeMap')}} | {{Spec2('DOM2 Core')}} | Ajout des méthodes `getNamedItemNS()`, `setNamedItemNS()` et `removeNamedItemNS()` |
| {{SpecName('DOM1', 'core.html#ID-1780488922', 'NamedNodeMap')}} | {{Spec2('DOM1')}} | Définition initiale. |
## Compatibilité des navigateurs
{{Compat("api.NamedNodeMap")}}
## Voir aussi
- {{domxref("Element.attributes")}}
- {{domxref("Attr")}}
- {{domxref("NodeList")}}
|