Ce type représente un attribut d'un élément DOM comme un objet. Dans la plupart des méthodes DOM, vous auriez probablement récupéré l'attribut directement comme une chaîne (par exemple, element.getAttribute(), mais certaines fonctions (par exemple, element.getAttributeNode()) ou des moyens d'itération donnent des types Attr.

Attention : À partir de Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), ceux qui vont être retirés afficheront des messages d'avertissement dans la console. Vous devriez modifier votre code en conséquence. Voir Propriétés et méthodes dépréciées pour une liste complète.

Propriétés

name Lecture seule
Le nom de l'attribut.
namespaceURI Lecture seule
Une Chaîne de caractères représentant l'URI de l'espace nom de l'attribut ou null s'il n'y a pas d'espace nom.
localName Lecture seule
Une Chaîne de caractères représentant la partie locale du nom qualifié de l'attribut.
prefix Lecture seule
Une Chaîne de caractères représentant le préfixe de l'espace nom de l'attribut, ou null si aucun préfixe n'est spécifié.
ownerElement Lecture seule
L'élément contenant l'attribut.

Note : DOM Niveau 4 a supprimé cette propriété . L'hypothèse était que puisque nous obtenons un objet Attr d'un Element, nous devrions déjà connaître les éléments associés.
Comme cela n'est pas vrai quand les objets Attr  sont retournés par Document.evaluate, le DOM Living Standard a réintroduit la propriété.

Gecko affiche une note de dépréciation à partir de Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4). Cette note a été supprimée dans Gecko 49.0 (Firefox 49.0 / Thunderbird 49.0 / SeaMonkey 2.46).

specified Lecture seule
Cette propriété renvoie toujours la valeur true. À l'origine, elle renvoyait true si l'attribut était explicitement spécifié dans le code source ou par un script, et false si sa valeur provenait de la valeur par défaut définie dans la DTD du document.
Value
La valeur de l'attribut.

Note: DOM Niveau 3 a défini namespaceURI, localName et prefix sur l'interface Node. Dans DOM4 ils ont été déplacés vers Attr.

Cette modification est implémentée dans Chrome depuis la version 46.0 et Firefox à partir de la version 48.0.

Propriétés et méthodes dépréciées

Les propriétés suivantes ont été dépréciées. Si elle est disponible, la méthode ou propriété de remplacement appropriée est fournie.

attributes
Cette propriété retourne désormais toujours NULL.
childNodes Obsolète depuis Gecko 14
Cette propriété retourne désormais toujours un NodeList  vide.
firstChild Obsolète depuis Gecko 14
Cette propriété retourne désormais toujours NULL.
isId Lecture seule
Indique si l'attribut est un "attribut ID". Un "attribut ID" étant un attribut dont la valeur devrait être unique dans un document DOM. En HTML DOM, "id" est le seul attribut ID, mais les documents XML peuvent en définir d'autres. Qu'un attribut soit unique ou non est souvent déterminé par  un DTD  ou une autre description de schéma.
lastChild Obsolète depuis Gecko 14
Cette propriété retourne désormais toujours NULL.
nextSibling
Cette propriété retourne désormais toujours NULL.
nodeName
Utilisez Attr.name à la place.
nodeType
Cette propriété retourne toujours 2. (ATTRIBUTE_NODE).
nodeValue
Utilisez Attr.value à la place.
ownerDocument
Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré.
parentNode
Cette propriété retourne désormais toujours NULL.
previousSibling
Cette propriété retourne désormais toujours NULL.
schemaTypeInfo Lecture seule
Les informations de type associées à cet attribut. Bien que l'information de type contenue dans cet attribut soit garantie après le chargement du document ou l'appel de Document.normalizeDocument, cette propriété peut ne pas être fiable si le nœud a été déplacé.
specified
Cette propriété retourne désormais toujours true.
textContent
Utilisez Attr.value à la place.


Les méthodes suivantes ont été dépréciées:

appendChild() Obsolète depuis Gecko 14
Modifiez à la place la valeur de Attr.value.
cloneNode()
Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré.
createAttribute()
Utilisez Attr.setAttribute() à la place.
createAttributeNS()
Utilisez Attr.setAttributeNS() à la place.
getAttributeNode()
Utilisez Attr.getAttribute() à la place.
getAttributeNodeNS()
Utilisez Attr.getAttributeNS() à la place.
hasAttributes() Obsolète depuis Gecko 21.0
Cette méthode retourne désormais toujours false.
hasChildNodes()
Cette méthode retourne désormais toujours false.
insertBefore()
Modifiez à la place la valeur de Attr.value.
isSupported()
Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré.
isEqualNode()
Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré.
normalize()
Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré.
removeAttributeNode()
Utilisez Attr.removeAttribute() à la place.
removeChild() Obsolète depuis Gecko 14
Modifiez à la place la valeur de Attr.value.
replaceChild() Obsolète depuis Gecko 14
Modifiez à la place la valeur de Attr.value.
setAttributeNode()
Utilisez Attr.setAttribute() à la place.
setAttributeNodeNS()
Utilisez Attr.setAttributeNS() à la place.

Spécifications

Spécification Statut Commentaire
DOM
La définition de 'Attr' dans cette spécification.
Standard évolutif Ajoute la propriété ownerElement property
DOM4
La définition de 'Attr' dans cette spécification.
Obsolete A déplacé les namespaceURI, prefix et localName de Node vers cet API et supprimé ownerElement, schemaTypeInfo et isId.
Document Object Model (DOM) Level 3 Core Specification
La définition de 'Attr' dans cette spécification.
Obsolete Définition initiale

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Oui)[1] (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Android Webview Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support (Oui) (Oui)[1] (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)[1]

[1] À partir de Chrome 45, cette propriété n'hérite plus de Node.

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : loella16, robin850, fscholz, ntrillaud, Jeremie, dexterneo
Dernière mise à jour par : loella16,