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 : dans DOM Core 1, 2 et 3, Attr hérite de l'objet Node. Ce n'est plus le cas dans DOM4. Afin d'implémenter Attr en accord avec la spécification, un travail a été entreprit pour ne plus hériter de Node
. Vous ne devriez pas utiliser les propriétés ou méthodes de Node
sur les objets Attr. À 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
isId
- Indique si l'attribut est un attribut "ID". Un attribut "ID" est un attribut dont la valeur attendue 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 une DTD ou toute autre description de schéma.
name
- Le nom de l'attribut.
ownerElement
Obsolète depuis Gecko 7.0 Obsolète depuis Gecko 29.0- Cette propriété a été supprimée depuis Firefox 29. Puisque vous ne pouvez obtenir des objets Attr qu'à partir d'éléments, vous devriez déjà connaître le propriétaire.
schemaTypeInfo
?
specified
Obsolète depuis Gecko 7.0- Cette propriété a été dépréciée et sera supprimée dans l'avenir, Elle retourne aujourd'hui toujours true. À l'origine, elle retournait true si l'attribut était explicitement spécifié dans le code source ou par un script, et false si sa valeur provenait de celui par défaut défini dans le DTD du document.
value
- La valeur de l'attribut.
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
- Cette propriété retourne désormais toujours
NULL
. firstChild
- Cette propriété retourne désormais toujours
NULL
. lastChild
- 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é.
ownerElement
- Puisque vous obtenez un objet Attr d'un
Element
, vous devriez déjà connaître l'élément associé. parentNode
- Cette propriété retourne désormais toujours NULL.
previousSibling
- Cette propriété retourne désormais toujours NULL.
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()
- 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()
- Modifiez à la place la valeur de
Attr.value
. replaceChild()
- Modifiez à la place la valeur de
Attr.value
. setAttributeNode()
- Utilisez
Attr.setAttribute()
à la place. setAttributeNodeNS()
- Utilisez
Attr.setAttributeNS()
à la place.