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 :

Spécification

• DOM Level 2 Core: getAttributeNS (en) — traduction en français (non normative)