DOM:element.getAttributeNS
Un article de MDC.
Sommaire |
[modifier] 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.
[modifier] Syntaxe
attrVal = element.getAttributeNS(namespace, name)
[modifier] 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é.
[modifier] 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
[modifier] 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 | setAttributeNS | setAttributeNode | setAttributeNodeNS |
| getAttribute | getAttributeNS | getAttributeNode | getAttributeNodeNS |
| hasAttribute | hasAttributeNS | - | - |
| removeAttribute | removeAttributeNS | removeAttributeNode | - |
Les méthodes DOM Level 1 ne prennent pas en compte les espaces de noms tandis que les méthodes DOM Level 2 le font. Les méthodes traitant directement les nœuds Attr sont très rarement utilisées.
[modifier] Spécification
- DOM Level 2 Core: getAttributeNS (en) — traduction en français (non normative)