XMLNode  - AS3

Objet contenant tous les attributs de l’occurrence de XMLNode spécifiée. L’objet XMLNode.attributes contient une variable pour chaque attribut de l’occurrence de XMLNode. Ces variables étant définies comme faisant partie de l’objet, elles sont généralement appelées propriétés de l’objet. La valeur de chaque attribut est enregistrée dans la propriété correspondante comme une chaîne. Par exemple, si un attribut est appelé color, vous récupérerez la valeur de l’attribut en spécifiant color comme nom de la propriété, tel qu’indiqué par le code suivant :

	 var myColor:String = doc.firstChild.attributes.color
	 

Tableau des enfants de l’objet XMLNode spécifié. Chaque élément du tableau est une référence à un objet XMLNode qui représente un nœud enfant. Cette propriété est en lecture seule et ne permet pas de manipuler les nœuds enfant. Utilisez les méthodes appendChild(), insertBefore() et removeNode() pour manipuler les nœuds enfant.

Cette propriété n’est pas définie pour les nœuds de texte (nodeType == 3).

Eléments de l’API associés

Evalue l’objet XMLDocument spécifié et fait référence au premier enfant dans la liste des enfants du nœud parent. Cette propriété est null si le nœud n’a pas d’enfants. Cette propriété est undefined si le nœud est un nœud de texte. Il s’agit d’une propriété en lecture seule qui ne peut pas être utilisée pour manipuler les nœuds enfant ; utilisez les méthodes appendChild(), insertBefore() et removeNode() pour manipuler les nœuds enfant.

Eléments de l’API associés

Valeur XMLNode qui fait référence au dernier enfant de la liste des enfants du nœud. La propriété XMLNode.lastChild est null si le nœud n’a pas d’enfants. Cette propriété ne peut pas être utilisée pour manipuler les nœuds enfant ; utilisez les méthodes appendChild(), insertBefore() et removeNode() pour manipuler les nœuds enfant.

Eléments de l’API associés

Partie locale du nom du nœud XML. Il s’agit du nom d’élément sans le préfixe d’espace de noms. Par exemple, le nœud <contact:mailbox/>bob@example.com</contact:mailbox> utilise le nom local « mailbox » et le préfixe « contact », ce qui forme « contact.mailbox ».

Vous pouvez accéder au préfixe d’espace de noms par l’intermédiaire de la propriété prefix de l’objet nœud XML. La propriété nodeName renvoie le nom complet (ce qui inclut le préfixe et le nom local).

Si le nœud XML a un préfixe, namespaceURI est la valeur de la déclaration xmlns de ce préfixe (URI) appelé en général l’URI d’espace de noms. La déclaration xmlns se trouve dans le nœud actuel ou dans un nœud plus élevé dans la hiérarchie XML.

Si le nœud XML n’a pas de préfixe, la valeur de la propriété namespaceURI dépend de l’existence d’un espace de noms défini par défaut (par exemple xmlns="http://www.example.com/"). Si un espace de noms par défaut existe, la valeur de la propriété namespaceURI est celle de l’espace de noms par défaut. Si aucun espace de noms par défaut n’existe, la propriété namespaceURI de ce nœud est une chaîne vide ("").

Vous pouvez utiliser la méthode getNamespaceForPrefix() pour identifier l’espace de noms associé à un préfixe spécifique. La propriété namespaceURI renvoie le préfixe associé au nom du nœud.

Eléments de l’API associés

Valeur XMLNode qui fait référence au frère suivant de la liste des enfants du nœud parent. La valeur de la propriété est null si le nœud n’est pas suivi par un nœud frère. Cette propriété ne peut pas être utilisée pour manipuler les nœuds enfant ; utilisez les méthodes appendChild(), insertBefore() et removeNode() pour manipuler les nœuds enfant.

Eléments de l’API associés

Chaîne représentant le nom de nœud de l’objet XMLNode. Si l’objet XMLNode est un élément XML (nodeType == 1), nodeName est le nom de la balise qui représente le nœud dans le fichier XML. Par exemple, TITLE est le nodeName d’une balise TITLE HTML. Si l’objet XMLNode est un nœud de texte (nodeType == 3), nodeName est null.

Eléments de l’API associés

Valeur de constante nodeType, à savoir XMLNodeType.ELEMENT_NODE pour un élément XML ou XMLNodeType.TEXT_NODE pour un nœud de texte.

nodeType est une valeur numérique définie d’après l’énumération NodeType spécifiée dans la recommandation DOM Level  1 du W3C : http://www.w3.org/tr/1998/REC-DOM-Level-1-19981001/level-one-core.html. Le tableau suivant répertorie les valeurs :

Dans Flash Player, la classe XMLNode intégrée prend uniquement en charge XMLNodeType.ELEMENT_NODE et XMLNodeType.TEXT_NODE.

Eléments de l’API associés

Valeur du nœud de l’objet XMLDocument. Si l’objet XMLDocument est un nœud de texte, nodeType est 3 et nodeValue est le texte du nœud. Si l’objet XMLDocument est un élément XML (nodeType est 1), nodeValue est null et en lecture seule.

Eléments de l’API associés

Valeur XMLNode qui fait référence au nœud parent de l’objet XML spécifié ou renvoie null si le nœud n’a pas de parent. Il s’agit d’une propriété en lecture seule qui ne peut pas être utilisée pour manipuler les nœuds enfant ; utilisez les méthodes appendChild(), insertBefore() et removeNode() pour manipuler les nœuds enfant.

Eléments de l’API associés

Préfixe du nom du nœud XML. Par exemple, le préfixe « contact » du nœud <contact:mailbox/>bob@example.com</contact:mailbox> et le nom local « mailbox », ce qui forme « contact.mailbox ».

La propriété nodeName d’un objet nœud XML renvoie le nom complet (ce qui inclut le préfixe et le nom local). Vous pouvez accéder à la partie locale du nom de l’élément par l’intermédiaire de la propriété localName.

Valeur XMLNode qui fait référence au frère précédent de la liste des enfants du nœud parent. La valeur de la propriété est null si le nœud n’a pas de nœud frère précédent. Cette propriété ne peut pas être utilisée pour manipuler les nœuds enfant ; utilisez les méthodes appendChild(), insertBefore() et removeNode() pour manipuler les nœuds enfant.

Eléments de l’API associés

Crée un objet XMLNode. Vous devez utiliser le constructeur pour créer un objet XMLNode avant d’appeler une des méthodes de la classe XMLNode.

Remarque : utilisez les méthodes createElement() et createTextNode() pour ajouter des éléments et des nœuds de texte à une arborescence de documents XML.

Eléments de l’API associés

Ajoute le nœud spécifié à la liste des enfants de l’objet XML. Cette méthode agit directement sur le nœud référencé par le paramètre childNode ; elle n’ajoute pas une copie du nœud. Si le nœud à ajouter existe déjà dans une autre arborescence, il est supprimé de son emplacement actuel une fois ajouté au nouvel emplacement. Si le paramètre childNode fait référence à un nœud qui existe déjà dans une autre arborescence XML, le nœud enfant ajouté est placé dans la nouvelle structure après sa suppression de son nœud parent existant.

Paramètres

Informations complémentaires

Construit et renvoie un nouveau nœud XML des mêmes type, nom, valeur et attributs que l’objet XML spécifié. Si deep est défini sur true, tous les nœuds enfant sont clonés de manière récursive, ce qui crée une copie exacte de l’arborescence du document de l’objet original.

Le clone du nœud qui est renvoyé n’est plus associé à l’arborescence de l’élément cloné. Par conséquent, nextSibling, parentNode et previousSibling ont tous une valeur null. Si le paramètre deep prend la valeur false, ou si le nœud my_xml n’a pas de nœuds enfant, firstChild et lastChild sont également null.

Paramètres

Renvoie l’URI d’espace de noms qui est associé au préfixe spécifié pour le nœud. Pour fixer l’URI, getPrefixForNamespace() remonte la hiérarchie XML depuis le nœud si nécessaire, et renvoie l’URI de l’espace de noms de la première déclaration xmlns du prefix donné.

Si aucun espace de noms n’est défini pour ledit préfixe, la méthode renvoie null.

Si vous spécifiez une chaîne vide ("") en tant que prefix et que ce nœud a un espace de noms par défaut (par exemple xmlns="http://www.example.com/"), la méthode renvoie cet URI d’espace de noms.

Paramètres

Eléments de l’API associés

Renvoie le préfixe qui est associé à l’URI d’espace de noms spécifié pour le nœud. Pour déterminer le préfixe, getPrefixForNamespace() remonte la hiérarchie XML depuis le nœud si nécessaire, et renvoie le préfixe de la première déclaration xmlns avec un URI d’espace de noms correspondant à ns.

Si aucune affectation xmlns de l’URI considéré n’existe, la méthode renvoie null. S’il existe une affectation xmlns de l’URI considéré mais qu’aucun préfixe ne lui est associé, la méthode renvoie une chaîne vide ("").

Paramètres

Eléments de l’API associés

Indique si l’objet XMLNode spécifié possède des nœuds enfant. Cette propriété correspond à true si l’objet XMLNode spécifié possède des nœuds enfant, à false dans le cas contraire.

Insère un nouveau nœud enfant dans la liste d’enfants de l’objet XML, avant le nœud beforeNode Si le paramètre beforeNode n’est pas défini ou est réglé sur null, le nœud est ajouté à l’aide de la méthode appendChild(). Si beforeNode n’est pas un enfant de my_xml, l’insertion échoue.

Paramètres

Eléments de l’API associés

Supprime l’objet XML spécifié de son parent. Supprime également tous les descendants du nœud.

Evalue l’objet XMLNode spécifié, crée une représentation sous forme de texte de la structure XML comprenant le nœud, les enfants et les attributs, et renvoie le résultat sous forme de chaîne.

Pour les objets XMLDocument de niveau supérieur (ceux créés avec le constructeur), la méthode XMLDocument.toString() produit la déclaration XML du document (enregistrée dans la propriété XMLDocument.xmlDecl), suivie de la déclaration DOCTYPE du document (enregistrée dans la propriété XMLDocument.docTypeDecl), suivie de la représentation sous forme de texte de tous les nœuds XML de l’objet. La déclaration XML n’est pas produite si la propriété XMLDocument.xmlDecl est null. La déclaration DOCTYPE n’est pas produite si la propriété XMLDocument.docTypeDecl est null.

Eléments de l’API associés