element.getAttributeNS

Résumé

getAttributeNS renvoie la valeur chaîne de l'attribut avec l'espace de noms et le nom donnés. Si l'attribut nommé n'existe pas, cette valeur sera soit null, soit "" (une chaîne vide) ; voir Notes pour plus de détails.

Syntaxe

attrVal =element.getAttributeNS(namespace,name)

Paramètres

attrVal
La valeur chaîne de l'attribut spécifié.
namespace
L'espace de noms de l'attribut spécifié.
name
Le nom de l'attribut spécifié.

Exemple

var div1 = document.getElementById("div1");
var a = div1.getAttributeNS("www.mozilla.org/ns/specialspace/", 
                            "special-align");
alert(a); // affiche la valeur de l'attribut special-align pour cet élément div

Notes

La méthode getAttributeNS diffère de getAttribute() en ce qu'elle permet de spécifier les attributs faisant partie d'un espace de noms particulier, comme dans l'exemple précédent, où l'attribut fait partie d'un espace de noms fictif « specialspace » de mozilla.

En gros, tous les navigateurs Web (Firefox, Internet Explorer, les versions récentes d'Opera, Safari, Konqueror et iCab, d'une manière non exhaustive) renvoient null lorsque l'attribut spécifié n'existe pas sur l'élément spécifié. La spécification DOM indique que la valeur de retour correcte dans ce cas est en réalité une chaîne vide , et certaines implémentations DOM ont ce comportement. Par conséquent, il faut utiliser hasAttributeNS() pour vérifier l'existence d'un attribut avant d'appeler getAttributeNS s'il est possible que l'attribut demandé n'existe pas sur l'élément spécifié.

Méthodes DOM traitant des attributs sur les éléments :

DOM Level 1 (le plus courant) DOM Level 2 DOM Level 1 traitant directement les nœuds Attr DOM Level 2 traitant directement les nœuds Attr
setAttribute (DOM 1) setAttributeNS setAttributeNode setAttributeNodeNS
getAttribute (DOM 1) getAttributeNS getAttributeNode getAttributeNodeNS
hasAttribute (DOM 2) hasAttributeNS - -
removeAttribute (DOM 1) removeAttributeNS removeAttributeNode -

Spécification

 

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : fscholz, teoli, khalid32, Mgjbot, BenoitL, Fredchat
Dernière mise à jour par : khalid32,