files/fr/web/api/element/setattributenodens/index.md


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

---
title: element.setAttributeNodeNS
slug: Web/API/Element/setAttributeNodeNS
tags:
  - API
  - DOM
  - Element
  - Méthodes
translation_of: Web/API/Element/setAttributeNodeNS
---
{{ APIRef("DOM") }}

`setAttributeNodeNS` ajoute un nouveau nœud attribut avec l'espace de noms et le nom spécifiés.

## Syntaxe

    replacedAttr = element.setAttributeNodeNS(attributeNode)

- `replacedAttr`
  - : Le nœud attribut remplacé, si applicable, renvoyé par cette fonction.
- `attributeNode`
  - : Un nœud `Attr`.

## Exemple

    // <div id="one" special-align="utterleft">one</div>
    // <div id="two">two</div>

    var myns = "http://www.mozilla.org/ns/specialspace";
    var d1 = document.getElementById("one");
    var d2 = document.getElementById("two");
    var a = d1.getAttributeNodeNS(myns, "special-align");
    d2.setAttributeNodeNS(a);

    alert(d2.attributes[1].value) // renvoie&nbsp;: "utterleft"

## Notes

Si l'attribut spécifié existe déjà sur l'élément, cet attribut est remplacé par le nouveau et l'ancien est renvoyé.

Notez que si vous essayez de définir sans cloner le noeud, Mozilla donne une erreur "Attribut déjà utilisé" NS_ERROR_DOM_INUSE_ATTRIBUTE_ERR, car le DOM nécessite que le clonage d'`Attr` soit réutilisé (contrairement aux autres Noeuds qui peuvent être déplacés).

{{ DOMAttributeMethods() }}

## Spécification

- [DOM Level 2 Core: setAttributeNodeNS (en)](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-ElSetAtNodeNS) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-ElSetAtNodeNS) (non normative)