DOMGecko

Recherche | Contact | English/Français |

Interface: Attr

Description: L'interface Attr représente un attribut d'un objet Element. Typiquement, les valeurs possible à cette attribut sont définit dans un DTD (document type definition)

Hérite de: Node

Bien que les objets Attr héritent de l'interface Node, le DOM ne les considère pas comme faisant partie de l'arbre du document puisqu'il ne sont pas des noeud-enfants des éléments qu'ils décrivent. Ainsi, les attributs parentNode, previousSibling et nextSibling ont des valeurs nulles (null) pour les objets Attr. Selon la DOM, les attributes sont des propriétés des éléments plutôt que des identités séparés des éléments auxquels ils sont associés. Cette perspective permet d'implémenter des fonctionnalités plus efficacement comme les attributs par défaut associé à tous les éléments d'un même type. De plus, les noeuds Attr ne peuvent pas être des enfants immédiats d'un DocumentFragment. Il peuvent cependant être lié à un noeud Element qui lui est contenu dans le DocumentFragment. En d'autres termes, les utilisateurs et les développeurs du DOM devrait être averti que les noeuds Attr ont des caractéristiques communes aux autres noeuds héritant de l'interface Node, mais qu'il sont toutefois différents et distincts.

La valeur de l'attribut devrait être determinée comme ceci: la valeur assignée explicitement à l'attribut est prédominante, dans les autres cas, s'il y a une valeur par défaut dans le DTD, la valeur de l'attribut est cette valeur par défaut. Noter que l'attribut nodeValue peut être aussi être utilisé pour retrouver la version "Chaîne de caractère" de la valeur de l'attribut.

En XML, lorsque la valeur peut contenir des entités référenciées, les noeuds enfants de l'objet Attr permettent une représentation de ces entités non étendue. Ces noeuds enfants peuvent être des noeuds Text ou EntityReference. Puisque les types de ces attributs peuvent être inconnus, il n'y a pas de valeurs "tokenized".

Exemple

var imgAttr = document.getElementsByTagName('img').item(0).attributes;

if ( imgAttr.getNamedItem('src') && imgAttr.getNamedItem('src').specified ) {
 alert('Le src de départ de cet élément était: ' + imgAttr.getNamedItem('src').value);
}

for (var i=0; i<imgAttr.length; i++ ) {
 alert(imgAttr.item(i).name + "=" + imgAttr.item(i).value );
}

Attributs

Méthodes

Constantes

Afficher IDL: court / long

Yan Morin - 2003-2005