aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/namednodemap/index.md
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")}}