Objecte objecte incorporat

Objecte XmlElement

Els objectes XmlElement representen elements en documents XML

Herència

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<class>XmlNode|nodeType;nodeName;nodeValue;ownerDocument;parentNode;childNodes;firstChild;lastChild;previousSibling;nextSibling|hasChildNodes();normalize();cloneNode();lookupPrefix();lookupNamespaceURI();insertBefore();insertAfter();appendChild();replaceChild();removeChild()] [<this>XmlElement|namespaceURI;prefix;localName;tagName;id;textContent;innerHTML;className;attributes|getAttribute();getAttributeNS();setAttribute();setAttributeNS();removeAttribute();removeAttributeNS();hasAttribute();hasAttributeNS();getElementsByTagName();getElementsByTagNameNS();getElementById();getElementsByClassName()] [object] <:- [XmlNode] [XmlNode] <:- [XmlElement] XmlNode nodeType nodeName nodeValue ownerDocument parentNode childNodes firstChild lastChild previousSibling nextSibling hasChildNodes() normalize() cloneNode() lookupPrefix() lookupNamespaceURI() insertBefore() insertAfter() appendChild() replaceChild() removeChild() XmlElement namespaceURI prefix localName tagName id textContent innerHTML className attributes getAttribute() getAttributeNS() setAttribute() setAttributeNS() removeAttribute() removeAttributeNS() hasAttribute() hasAttributeNS() getElementsByTagName() getElementsByTagNameNS() getElementById() getElementsByClassName() object toString() toJSON()

Atributs de membre

namespaceURI

String, l’URI de l’espai de noms de l’element de consulta. Si el node seleccionat no té espai de noms, aquest atribut retorna NULL

1
readonly String XmlElement.namespaceURI;

prefix

Cadena, consulta i estableix el prefix de l’espai de noms de l’element. Si el node seleccionat no té espai de noms, aquest atribut retorna NULL

1
String XmlElement.prefix;

localName

String, el nom local de l'element de consulta. Si el node seleccionat no té espai de noms, aquest atribut és equivalent a nodeName

1
readonly String XmlElement.localName;

tagName

Cadena, retorna el nom de l’etiqueta de l’element

1
readonly String XmlElement.tagName;

id

Cadena, consulta i estableix l'atribut id de l'element

1
String XmlElement.id;

textContent

Cadena, consulta i defineix el text de l'element seleccionat. Quan feu una consulta, torneu els valors de tots els nodes de text del node de l'element; en establir-los, suprimiu tots els nodes secundaris i substituïu-los per un node de text únic.

1
String XmlElement.textContent;

innerHTML

Encadenar, consultar i definir el text HTML de l’element seleccionat, només vàlid en mode html. Quan feu una consulta, torneu el codi HTML de tots els nodes fills del node element; en configurar-los, suprimiu tots els nodes fills i substituïu-los per l'HTML especificat després de descodificar-los.

1
String XmlElement.innerHTML;

className

Cadena, consulta i defineix l'atribut class de l'element, només vàlid en mode html

1
String XmlElement.className;

attributes

XmlNamedNodeMap, Retorna el NamedNodeMap que conté els atributs del node seleccionat. Si el node seleccionat no és un element, aquest atribut retorna NULL.

1
readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

Enter, retorna el tipus de node del node

1
readonly Integer XmlElement.nodeType;

El nodeType de diferents objectes retornarà diferents valors:


nodeName

Cadena, retorna el nom del node, segons el seu tipus

1
readonly String XmlElement.nodeName;

El nodeName de diferents objectes retornarà diferents valors:


nodeValue

Cadena, retorna el nom del node, segons el seu tipus

1
String XmlElement.nodeValue;

El nodeName de diferents objectes retornarà diferents valors:


ownerDocument

XmlDocument, Retorna l'element arrel del node (XmlDocument Objecte)

1
readonly XmlDocument XmlElement.ownerDocument;

parentNode

XmlNode, Pot retornar el node pare d'un node

1
readonly XmlNode XmlElement.parentNode;

childNodes

XmlNodeList, Retorna la llista de nodes dels nodes fills del node especificat

1
readonly XmlNodeList XmlElement.childNodes;

firstChild

XmlNode, Retorna el primer node fill del node

1
readonly XmlNode XmlElement.firstChild;

lastChild

XmlNode, Retorna l'últim node fill del node

1
readonly XmlNode XmlElement.lastChild;

previousSibling

XmlNode, Retorna el node immediatament abans d’un determinat node (al mateix nivell d’arbre), si no hi ha aquest node, l’atribut torna nul

1
readonly XmlNode XmlElement.previousSibling;

nextSibling

XmlNode, Retorna el node immediatament després d'un element (al mateix nivell d'arbre), si no hi ha aquest node, la propietat torna nul

1
readonly XmlNode XmlElement.nextSibling;

Funció de membre

getAttribute

Consulteu el valor d'un atribut per nom

1
String XmlElement.getAttribute(String name);

Paràmetres de trucada:

  • name: Cadena, especifiqueu el nom de la propietat de la consulta

Resultat de retorn:

  • String, Retorna el valor de l'atribut

getAttributeNS

Obteniu el valor de l'atribut per URI i nom de l'espai de noms

1 2
String XmlElement.getAttributeNS(String namespaceURI, String localName);

Paràmetres de trucada:

  • namespaceURI: Cadena, especifiqueu l’URI de l’espai de noms de la consulta
  • localName: Cadena, especifiqueu el nom de la propietat de la consulta

Resultat de retorn:

  • String, Retorna el valor de l'atribut

setAttribute

Creeu o canvieu una propietat nova

1 2
XmlElement.setAttribute(String name, String value);

Paràmetres de trucada:

  • name: Cadena, especifiqueu el nom de la propietat que voleu establir
  • value: Cadena, especifiqueu el valor de l'atribut que cal establir

Aquest mètode estableix l'atribut especificat al valor especificat. Si no hi ha cap atribut amb el nom especificat, el mètode crearà un atribut nou


setAttributeNS

Crear o canviar atributs amb espai de noms

1 2 3
XmlElement.setAttributeNS(String namespaceURI, String qualifiedName, String value);

Paràmetres de trucada:

  • namespaceURI: Cadena, especifiqueu l’URI de l’espai de noms que cal establir
  • qualifiedName: Cadena, especifiqueu el nom de la propietat que voleu establir
  • value: Cadena, especifiqueu el valor de l'atribut que cal establir

Aquest mètode és similar al mètode setAttribute, excepte que l'atribut que cal crear o establir està especificat per l'URI de l'espai de noms i el nom qualificat (que consisteix en el prefix de l'espai de noms, els dos punts i el nom local a l'espai de noms). A més de canviar el valor d'un atribut, l'ús d'aquest mètode també pot canviar el prefix de l'espai de noms de l'atribut


removeAttribute

Suprimiu l'atribut especificat per nom

1
XmlElement.removeAttribute(String name);

Paràmetres de trucada:

  • name: Cadena, especifiqueu el nom de l'atribut suprimit

removeAttributeNS

Suprimiu els atributs especificats per nom i espai de noms

1 2
XmlElement.removeAttributeNS(String namespaceURI, String localName);

Paràmetres de trucada:

  • namespaceURI: Cadena, especifiqueu l’URI de l’espai de noms que voleu suprimir
  • localName: Cadena, especifiqueu el nom de l'atribut suprimit

hasAttribute

Consulteu si el node actual té un atribut amb el nom especificat

1
Boolean XmlElement.hasAttribute(String name);

Paràmetres de trucada:

  • name: Cadena, especifiqueu el nom de l'atribut de la consulta

Resultat de retorn:

  • Boolean, Si el node de l'element actual té l'atribut especificat, torna true, en cas contrari, torna false

hasAttributeNS

Consulteu si el node actual té atributs de l'espai de noms i el nom especificats

1 2
Boolean XmlElement.hasAttributeNS(String namespaceURI, String localName);

Paràmetres de trucada:

  • namespaceURI: Cadena, especifiqueu l'URI de l'espai de noms que voleu consultar
  • localName: Cadena, especifiqueu el nom de l'atribut de la consulta

Resultat de retorn:

  • Boolean, Si el node de l'element actual té l'atribut especificat, torna true, en cas contrari, torna false

getElementsByTagName

Retorna tots els elements amb el nom especificat XmlNodeList

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

Paràmetres de trucada:

  • tagName: String, el nom de l'etiqueta que s'ha de recuperar. El valor "*" coincideix amb totes les etiquetes

Resultat de retorn:

  • XmlNodeList, Del node XmlElement amb la marca especificada a l'arbre del node XmlNodeListconjunt. L'ordre dels nodes d'elements retornats és l'ordre en què apareixen al document d'origen.

Aquest mètode recorrerà els descendents de l'element especificat i retornarà un node XmlElement XmlNodeListObjecte, que significa tots els elements del document amb el nom d'etiqueta especificat. L'ordre dels elements de la matriu retornada és l'ordre en què apareixen al codi font del document.

XmlDocument La interfície també defineix el mètode getElementsByTagName, que és similar a aquest mètode, però recorre tot el document en lloc de recórrer els descendents d'un element.


getElementsByTagNameNS

Retorna tots els elements amb l'espai de noms i el nom especificats XmlNodeList

1 2
XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI, String localName);

Paràmetres de trucada:

  • namespaceURI: Cadena, especifiqueu l'URI de l'espai de noms que voleu consultar
  • localName: String, el nom de l'etiqueta que s'ha de recuperar. El valor "*" coincideix amb totes les etiquetes

Resultat de retorn:

  • XmlNodeList, Del node XmlElement amb la marca especificada a l'arbre del node XmlNodeListconjunt. L'ordre dels nodes d'elements retornats és l'ordre en què apareixen al document d'origen.

Aquest mètode és similar al mètode getElementsByTagName, tret que el nom de l’etiqueta de l’element que voleu obtenir s’especifica com una combinació de l’URI de l’espai de noms i el nom local definit a l’espai de noms.


getElementById

Retorna l'element amb l'atribut id especificat

1
XmlElement XmlElement.getElementById(String id);

Paràmetres de trucada:

  • id: Cadena, identificador que s'ha de recuperar

Resultat de retorn:

  • XmlElement, Node XmlElement amb l'atribut id especificat a l'arbre del node

Aquest mètode recorrerà els nodes descendents de l'element especificat i retornarà un objecte de node XmlElement que representi el primer element de document amb l'atribut id especificat. .

XmlDocument La interfície també defineix el mètode getElementsByTagName, que és similar a aquest mètode, però recorre tot el document en lloc de recórrer els descendents d'un element.


getElementsByClassName

Retorna una llista de nodes de tots els elements amb el nom de classe especificat

1
XmlNodeList XmlElement.getElementsByClassName(String className);

Paràmetres de trucada:

  • className: String, el nom de la classe que es recuperarà

Resultat de retorn:

  • XmlNodeList, El node XmlElement amb el nom de classe especificat a l'arbre del document XmlNodeListconjunt. L'ordre dels nodes d'elements retornats és l'ordre en què apareixen al document d'origen.

Aquest mètode retornarà un fitxer XmlNodeList Objecte (es pot tractar com una matriu de només lectura). Aquest objecte emmagatzema tots els nodes XmlElement amb el nom de classe especificat al document. L'ordre en què s'emmagatzemen és l'ordre en què apareixen al document d'origen. XmlNodeList L'objecte és "actiu", és a dir, si s'afegeix o elimina un element amb el nom d'etiqueta especificat al document, el seu contingut s'actualitzarà automàticament segons sigui necessari.


hasChildNodes

Consulteu si hi ha nodes secundaris

1
Boolean XmlElement.hasChildNodes();

Resultat de retorn:

  • Boolean, Torneu a true si hi ha nodes secundaris, en cas contrari, torneu a false

normalize

Combineu els nodes de text adjacents i suprimiu els nodes de text buits

1
XmlElement.normalize();

Aquest mètode recorrerà tots els descendents del node actual i normalitzarà el document suprimint el node de text buit i fusionant tots els nodes de text adjacents. Aquest mètode és útil per simplificar l'estructura de l'arbre del document després d'inserir o suprimir nodes.


cloneNode

Creeu una còpia exacta del node especificat

1
XmlNode XmlElement.cloneNode(Boolean deep = true);

Paràmetres de trucada:

  • deep: Booleà, si voleu copiar en profunditat, quan és cert, el node clonat clonarà tots els nodes fills del node original

Resultat de retorn:

Aquest mètode copiarà i retornarà una còpia del node que l’ha anomenat. Si el paràmetre que se li passa és cert, també copiarà recursivament tots els descendents del node actual. En cas contrari, només copia el node actual. El node retornat no pertany a l'arbre del document i la seva propietat parentNode és nul·la. Quan es copiï el node Element, es copiaran tots els seus atributs.


lookupPrefix

Retorna el prefix que coincideix amb l'URI d'espai de noms especificat al node actual

1
String XmlElement.lookupPrefix(String namespaceURI);

Paràmetres de trucada:

  • namespaceURI: Cadena, especifiqueu l'URI de l'espai de noms coincident

Resultat de retorn:

  • String, Retorna el prefix coincident, torna nul si no coincideix

lookupNamespaceURI

Retorna l'URI de l'espai de noms que coincideix amb el prefix especificat al node actual

1
String XmlElement.lookupNamespaceURI(String prefix);

Paràmetres de trucada:

  • prefix: Cadena, especifiqueu el prefix coincident

Resultat de retorn:

  • String, Retorna l'URI de l'espai de noms coincident, torna nul si no coincideix

insertBefore

Inseriu un node fill nou abans del node fill existent

1 2
XmlNode XmlElement.insertBefore(XmlNode newChild, XmlNode refChild);

Paràmetres de trucada:

  • newChild: XmlNode, Inseriu un nou node
  • refChild: XmlNode, Inseriu un nou node abans d'aquest node

Resultat de retorn:

  • XmlNode, Retorna el nou node fill

Si newChild ja existeix a l'arbre del document, se suprimirà de l'arbre del document i es reintroduirà a la seva nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. En altres paraules, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.


insertAfter

Inseriu un node fill nou després del node fill existent

1 2
XmlNode XmlElement.insertAfter(XmlNode newChild, XmlNode refChild);

Paràmetres de trucada:

  • newChild: XmlNode, Inseriu un nou node
  • refChild: XmlNode, Inseriu un nou node després d’aquest node

Resultat de retorn:

  • XmlNode, Retorna el nou node fill

Si newChild ja existeix a l'arbre del document, se suprimirà de l'arbre del document i es reintroduirà a la seva nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. En altres paraules, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.


appendChild

Afegiu un node fill nou al final de la llista de nodes fills del node

1
XmlNode XmlElement.appendChild(XmlNode newChild);

Paràmetres de trucada:

  • newChild: XmlNode, Especifiqueu el node afegit

Resultat de retorn:

  • XmlNode, Retorna aquest nou node fill

Si newChild ja existeix a l'arbre del document, se suprimirà de l'arbre del document i es reintroduirà a la seva nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. En altres paraules, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.


replaceChild

Substituïu un node fill per un altre

1 2
XmlNode XmlElement.replaceChild(XmlNode newChild, XmlNode oldChild);

Paràmetres de trucada:

  • newChild: XmlNode, Especifiqueu un nou node
  • oldChild: XmlNode, Especifiqueu el node a substituir

Resultat de retorn:

  • XmlNode, Si la substitució és correcta, aquest mètode pot retornar el node substituït; si la substitució falla, torna nul

Si newChild ja existeix a l'arbre del document, se suprimirà de l'arbre del document i es reintroduirà a la seva nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. En altres paraules, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.


removeChild

Elimineu un node de la llista de nodes secundaris

1
XmlNode XmlElement.removeChild(XmlNode oldChild);

Paràmetres de trucada:

  • oldChild: XmlNode, Especifiqueu el node a suprimir

Resultat de retorn:

  • XmlNode, Si la supressió és correcta, aquest mètode pot retornar el node suprimit; si falla, torna nul

toString

Retorna la representació de cadena de l'objecte, generalment retorna "[Objecte natiu]", l'objecte es pot tornar a implementar segons les seves pròpies característiques

1
String XmlElement.toString();

Resultat de retorn:

  • String, Retorna la representació de cadena de l'objecte

toJSON

Retorna la representació en format JSON de l'objecte, generalment retorna una col·lecció d'atributs llegibles definits per l'objecte

1
Value XmlElement.toJSON(String key = "");

Paràmetres de trucada:

  • key: Cadena, sense utilitzar

Resultat de retorn:

  • Value, Retorna un valor que conté JSON serialitzable