ObjectXmlElement
Un oggetto XmlElement rappresenta un elemento in un documento XML
rapporto ereditario
attributo membro
namespaceURI
String, l'URI dello spazio dei nomi dell'elemento di query. Se il nodo selezionato non ha spazio dei nomi, questa proprietà restituisce NULL
1readonly String XmlElement.namespaceURI;
prefix
Stringa, interroga e imposta il prefisso dello spazio dei nomi dell'elemento. Se il nodo selezionato non ha spazio dei nomi, questa proprietà restituisce NULL
1String XmlElement.prefix;
localName
String, il nome locale dell'elemento di query. Se il nodo selezionato non ha spazio dei nomi, questa proprietà equivale a nodeName
1readonly String XmlElement.localName;
tagName
String, restituisce il nome del tag dell'elemento
1readonly String XmlElement.tagName;
id
Stringa, query e imposta l'attributo id dell'elemento
1String XmlElement.id;
innerHTML
Stringa, interroga e imposta il testo HTML dell'elemento selezionato, valido solo in modalità html. Durante l'interrogazione, restituisce la codifica HTML di tutti i nodi figlio nel nodo dell'elemento; durante l'impostazione, elimina tutti i nodi figlio e li sostituisce con la decodifica HTML specificata.
1String XmlElement.innerHTML;
className
Stringa, interroga e imposta l'attributo class dell'elemento, valido solo in modalità html
1String XmlElement.className;
attributes
XmlNamedNodeMap, restituisce un NamedNodeMap contenente gli attributi dei nodi selezionati. Se il nodo selezionato non è un elemento, questa proprietà restituisce NULL.
1readonly XmlNamedNodeMap XmlElement.attributes;
nodeType
Integer, il tipo di nodo del nodo restituito
1readonly Integer XmlElement.nodeType;
Il nodeType di oggetti diversi restituirà valori diversi:
- XmlElement: ELEMENT_NODE(1)
- XmlAttr: ATTRIBUTE_NODE(2)
- XmlText: TEXT_NODE(3)
- XmlCDATASection: CDATA_SECTION_NODE(4)
- XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
- XmlComment: COMMENT_NODE(8)
- XmlDocument: DOCUMENT_NODE(9)
- XmlDocumentType: DOCUMENT_TYPE_NODE(10)
nodeName
String, restituisce il nome del nodo, in base al suo tipo
1readonly String XmlElement.nodeName;
Il nodeName di diversi oggetti restituirà valori diversi:
- XmlElement: nome dell'elemento
- XmlAttr: nome della proprietà
- XmlText: #testo
- XmlCDATASection: #sezione-cdata
- XmlProcessingInstruction: Restituisce il target di destinazione specificato
- XmlComment: #commento
- XmlDocument: #documento
- XmlDocumentType: nome del tipo di documento
nodeValue
String, restituisce il nome del nodo, in base al suo tipo
1String XmlElement.nodeValue;
Il nodeName di diversi oggetti restituirà valori diversi:
- XmlElement: nullo
- XmlAttr: il valore dell'attributo
- XmlText: il contenuto del nodo
- XmlCDATASection: il contenuto del nodo
- XmlProcessingInstruction: restituisce i dati del contenuto specificato
- XmlComment: testo del commento
- XmlDocument: nullo
- XmlDocumentType: nullo
ownerDocument
XmlDocument, restituisce l'elemento radice del nodo (XmlDocumentoggetto)
1readonly XmlDocument XmlElement.ownerDocument;
parentNode
XmlNode, che restituisce il nodo padre di un nodo
1readonly XmlNode XmlElement.parentNode;
childNodes
XmlNodeList, restituisce un elenco di nodi figli del nodo specificato
1readonly XmlNodeList XmlElement.childNodes;
children
XmlNodeList, restituisce un elenco di nodi dei nodi dell'elemento figlio del nodo specificato
1readonly XmlNodeList XmlElement.children;
firstChild
XmlNode, restituisce il primo nodo figlio del nodo
1readonly XmlNode XmlElement.firstChild;
lastChild
XmlNode, restituisce l'ultimo nodo figlio del nodo
1readonly XmlNode XmlElement.lastChild;
previousSibling
XmlNode, restituisce il nodo immediatamente prima di un nodo (allo stesso livello dell'albero), se non esiste tale nodo, allora questa proprietà restituisce null
1readonly XmlNode XmlElement.previousSibling;
nextSibling
XmlNode, restituisce il nodo immediatamente successivo a un elemento (nella stessa gerarchia ad albero), se tale nodo non esiste, la proprietà restituisce null
1readonly XmlNode XmlElement.nextSibling;
firstElementChild
XmlNode, restituisce il primo nodo dell'elemento figlio del nodo
1readonly XmlNode XmlElement.firstElementChild;
lastElementChild
XmlNode, restituisce l'ultimo nodo dell'elemento figlio del nodo
1readonly XmlNode XmlElement.lastElementChild;
previousElementSibling
XmlNode, restituisce l'elemento node immediatamente prima di un nodo (allo stesso livello dell'albero), se non esiste tale nodo, allora questa proprietà restituisce null
1readonly XmlNode XmlElement.previousElementSibling;
nextElementSibling
XmlNode, restituisce il nodo dell'elemento immediatamente successivo a un elemento (nella stessa gerarchia ad albero), se tale nodo non esiste, la proprietà restituisce null
1readonly XmlNode XmlElement.nextElementSibling;
textContent
String, interroga e imposta il testo dell'elemento selezionato. Durante l'interrogazione, restituisce i valori di tutti i nodi di testo all'interno del nodo dell'elemento; durante l'impostazione, elimina tutti i nodi figli e li sostituisce con un singolo nodo di testo.
1String XmlElement.textContent;
funzione membro
getAttribute
Interroga il valore di un attributo per nome
1String XmlElement.getAttribute(String name);
Parametri di chiamata:
- name: String, specifica il nome dell'attributo della query
risultato di ritorno:
- String, restituisce il valore della proprietà
getAttributeNS
Ottieni il valore dell'attributo in base all'URI e al nome dello spazio dei nomi
1
2String XmlElement.getAttributeNS(String namespaceURI,
String localName);
Parametri di chiamata:
- namespaceURI: String, specifica l'URI dello spazio dei nomi della query
- localName: String, specifica il nome dell'attributo della query
risultato di ritorno:
- String, restituisce il valore della proprietà
setAttribute
creare o modificare un nuovo attributo
1
2XmlElement.setAttribute(String name,
String value);
Parametri di chiamata:
- name: String, specifica il nome della proprietà da impostare
- value: String, specifica il valore dell'attributo da impostare
Questo metodo imposta la proprietà specificata sul valore specificato. Se una proprietà con il nome specificato non esiste, il metodo creerà una nuova proprietà
setAttributeNS
creare o modificare un attributo namespace
1
2
3XmlElement.setAttributeNS(String namespaceURI,
String qualifiedName,
String value);
Parametri di chiamata:
- namespaceURI: String, specifica l'URI dello spazio dei nomi da impostare
- qualifiedName: String, specifica il nome della proprietà da impostare
- value: String, specifica il valore dell'attributo da impostare
Questo metodo è simile al metodo setAttribute, tranne per il fatto che l'attributo da creare o impostare è specificato dall'URI dello spazio dei nomi e dal nome completo (costituito dal prefisso dello spazio dei nomi, dai due punti e dal nome locale nello spazio dei nomi). Oltre a modificare il valore di un attributo, questo metodo può anche modificare il prefisso dello spazio dei nomi dell'attributo
removeAttribute
Elimina l'attributo specificato per nome
1XmlElement.removeAttribute(String name);
Parametri di chiamata:
- name: String, specifica il nome della proprietà da eliminare
removeAttributeNS
Rimuove gli attributi specificati per spazio dei nomi e nome
1
2XmlElement.removeAttributeNS(String namespaceURI,
String localName);
Parametri di chiamata:
- namespaceURI: String, specifica l'URI dello spazio dei nomi da eliminare
- localName: String, specifica il nome della proprietà da eliminare
hasAttribute
Interroga se il nodo corrente ha un attributo con il nome specificato
1Boolean XmlElement.hasAttribute(String name);
Parametri di chiamata:
- name: String, specifica il nome dell'attributo della query
risultato di ritorno:
- Boolean, se il nodo dell'elemento corrente ha l'attributo specificato, restituisce true, altrimenti restituisce false
hasAttributeNS
Interroga se il nodo corrente ha un attributo con lo spazio dei nomi e il nome specificati
1
2Boolean XmlElement.hasAttributeNS(String namespaceURI,
String localName);
Parametri di chiamata:
- namespaceURI: String, specifica l'URI dello spazio dei nomi da interrogare
- localName: String, specifica il nome dell'attributo della query
risultato di ritorno:
- Boolean, se il nodo dell'elemento corrente ha l'attributo specificato, restituisce true, altrimenti restituisce false
getElementsByTagName
restituisce tutti gli elementi con il nome specificatoXmlNodeList
1XmlNodeList XmlElement.getElementsByTagName(String tagName);
Parametri di chiamata:
- tagName: String, il nome del tag da recuperare. Un valore di "*" corrisponde a tutti i tag
risultato di ritorno:
- XmlNodeList, il nodo XmlElement nell'albero dei nodi con il tag specificatoXmlNodeListraccogliere. I nodi degli elementi restituiti sono nell'ordine in cui appaiono nel documento di origine.
Questo metodo attraverserà i nodi discendenti dell'elemento specificato e restituirà un nodo XmlElementXmlNodeListOggetto che rappresenta tutti gli elementi del documento con il nome di tag specificato. L'ordine degli elementi nell'array restituito è l'ordine in cui appaiono nel codice sorgente del documento.
XmlDocumentL'interfaccia definisce anche il metodo getElementsByTagName, che è simile a questo metodo, ma attraversa l'intero documento anziché i discendenti di un elemento.
getElementsByTagNameNS
Restituisce tutti gli elementi con lo spazio dei nomi e il nome specificatiXmlNodeList
1
2XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI,
String localName);
Parametri di chiamata:
- namespaceURI: String, specifica l'URI dello spazio dei nomi da interrogare
- localName: String, il nome del tag da recuperare. Un valore di "*" corrisponde a tutti i tag
risultato di ritorno:
- XmlNodeList, il nodo XmlElement nell'albero dei nodi con il tag specificatoXmlNodeListraccogliere. I nodi degli elementi restituiti sono nell'ordine in cui appaiono nel documento di origine.
Questo metodo è simile al metodo getElementsByTagName, tranne per il fatto che il nome del tag dell'elemento che si desidera ottenere è specificato come una combinazione dell'URI dello spazio dei nomi e del nome locale definito nello spazio dei nomi.
getElementById
Restituisce l'elemento con l'attributo id specificato
1XmlElement XmlElement.getElementById(String id);
Parametri di chiamata:
- id: String, l'id da recuperare
risultato di ritorno:
- XmlElement, il nodo XmlElement con l'attributo id specificato nell'albero dei nodi
Questo metodo attraverserà i nodi discendenti dell'elemento specificato e restituirà un oggetto nodo XmlElement che rappresenta il primo elemento del documento con l'attributo id specificato. .
XmlDocumentL'interfaccia definisce anche il metodo getElementsByTagName, che è simile a questo metodo, ma attraversa l'intero documento anziché i discendenti di un elemento.
getElementsByClassName
Restituisce un elenco di nodi di tutti gli elementi con il nome di classe specificato
1XmlNodeList XmlElement.getElementsByClassName(String className);
Parametri di chiamata:
- className: String, il nome della classe da recuperare
risultato di ritorno:
- XmlNodeList, il nodo XmlElement con il nome della classe specificato nell'albero del documentoXmlNodeListraccogliere. I nodi degli elementi restituiti sono nell'ordine in cui appaiono nel documento di origine.
Questo metodo restituirà aXmlNodeListObject (può essere trattato come una matrice di sola lettura) che archivia tutti i nodi XmlElement con il nome di classe specificato nel documento nell'ordine in cui vengono visualizzati nel documento di origine.XmlNodeListL'oggetto è "live", cioè se un elemento con il nome tag specificato viene aggiunto o rimosso dal documento, il suo contenuto viene aggiornato automaticamente se necessario.
hasChildNodes
Interroga se ci sono nodi figlio
1Boolean XmlElement.hasChildNodes();
risultato di ritorno:
- Boolean, restituisce true se sono presenti nodi figlio, altrimenti restituisce false
normalize
Unisci i nodi di testo adiacenti ed elimina i nodi di testo vuoti
1XmlElement.normalize();
Questo metodo eseguirà l'iterazione su tutti i discendenti del nodo corrente, normalizzerà il documento rimuovendo i nodi di testo vuoti e unendo tutti i nodi di testo adiacenti. Questo metodo è utile per semplificare la struttura dell'albero del documento dopo l'inserimento o l'eliminazione dei nodi.
cloneNode
Crea una copia esatta del nodo specificato
1XmlNode XmlElement.cloneNode(Boolean deep = true);
Parametri di chiamata:
- deep: booleano, se eseguire una copia profonda, se vero, il nodo clonato clonerà tutti i nodi figli del nodo originale
risultato di ritorno:
- XmlNode, restituisce il nodo copiato
Questo metodo copierà e restituirà una copia del nodo su cui è stato chiamato. Se il parametro passato è vero, copierà anche in modo ricorsivo tutti i nodi discendenti del nodo corrente. Altrimenti, copia solo il nodo corrente. Il nodo restituito non appartiene all'albero del documento e la sua proprietà parentNode è nulla. Quando si copia un nodo Elemento, verranno copiati tutti i suoi attributi.
lookupPrefix
Restituisce i prefissi corrispondenti all'URI dello spazio dei nomi specificato nel nodo corrente
1String XmlElement.lookupPrefix(String namespaceURI);
Parametri di chiamata:
- namespaceURI: String, specifica l'URI dello spazio dei nomi corrispondente
risultato di ritorno:
- String, restituisce il prefisso corrispondente, restituisce null se non corrisponde
lookupNamespaceURI
Restituisce gli URI dello spazio dei nomi corrispondenti al prefisso specificato nel nodo corrente
1String XmlElement.lookupNamespaceURI(String prefix);
Parametri di chiamata:
- prefix: String, specifica il prefisso corrispondente
risultato di ritorno:
- String, restituisce l'URI dello spazio dei nomi corrispondente, restituisce null se non corrisponde
insertBefore
Inserisci un nuovo nodo figlio prima di un nodo figlio esistente
1
2XmlNode XmlElement.insertBefore(XmlNode newChild,
XmlNode refChild);
Parametri di chiamata:
- newChild:XmlNode, inserendo un nuovo nodo
- refChild:XmlNode, inserire un nuovo nodo prima di questo nodo
risultato di ritorno:
- XmlNode, restituisce il nuovo nodo figlio
Se newChild esiste già nell'albero del documento, verrà rimosso dall'albero del documento e reinserito nella sua nuova posizione. I nodi di un documento (oi nodi creati da un documento) non possono essere inseriti in un altro documento. Cioè, la proprietà ownerDocument di newChild deve essere uguale alla proprietà ownerDocument del nodo corrente.
insertAfter
Inserisci un nuovo nodo figlio dopo un nodo figlio esistente
1
2XmlNode XmlElement.insertAfter(XmlNode newChild,
XmlNode refChild);
Parametri di chiamata:
risultato di ritorno:
- XmlNode, restituisce il nuovo nodo figlio
Se newChild esiste già nell'albero del documento, verrà rimosso dall'albero del documento e reinserito nella sua nuova posizione. I nodi di un documento (oi nodi creati da un documento) non possono essere inseriti in un altro documento. Cioè, la proprietà ownerDocument di newChild deve essere uguale alla proprietà ownerDocument del nodo corrente.
appendChild
Aggiunge un nuovo nodo figlio alla fine dell'elenco dei nodi figlio del nodo
1XmlNode XmlElement.appendChild(XmlNode newChild);
Parametri di chiamata:
- newChild:XmlNode, specifica il nodo aggiunto
risultato di ritorno:
- XmlNode, restituisce questo nuovo nodo figlio
Se newChild esiste già nell'albero del documento, verrà rimosso dall'albero del documento e reinserito nella sua nuova posizione. I nodi di un documento (oi nodi creati da un documento) non possono essere inseriti in un altro documento. Cioè, la proprietà ownerDocument di newChild deve essere uguale alla proprietà ownerDocument del nodo corrente.
replaceChild
Sostituisci un nodo figlio con un altro
1
2XmlNode XmlElement.replaceChild(XmlNode newChild,
XmlNode oldChild);
Parametri di chiamata:
risultato di ritorno:
- XmlNode, se la sostituzione ha esito positivo, questo metodo può restituire il nodo sostituito, se la sostituzione non riesce, restituirà null
Se newChild esiste già nell'albero del documento, verrà rimosso dall'albero del documento e reinserito nella sua nuova posizione. I nodi di un documento (oi nodi creati da un documento) non possono essere inseriti in un altro documento. Cioè, la proprietà ownerDocument di newChild deve essere uguale alla proprietà ownerDocument del nodo corrente.
removeChild
Rimuove un nodo dall'elenco dei nodi figlio
1XmlNode XmlElement.removeChild(XmlNode oldChild);
Parametri di chiamata:
- oldChild:XmlNode, specificando il nodo da eliminare
risultato di ritorno:
- XmlNode, se l'eliminazione ha esito positivo, questo metodo può restituire il nodo eliminato, se fallisce, restituirà null
toString
Restituisce la rappresentazione in stringa dell'oggetto, generalmente restituisce "[Native Object]", l'oggetto può essere reimplementato secondo le proprie caratteristiche
1String XmlElement.toString();
risultato di ritorno:
- String, restituisce una rappresentazione in forma di stringa dell'oggetto
toJSON
Restituisce la rappresentazione in formato JSON dell'oggetto, in genere restituisce una raccolta di proprietà leggibili definite dall'oggetto
1Value XmlElement.toJSON(String key = "");
Parametri di chiamata:
- key: stringa, non utilizzata
risultato di ritorno:
- Value, che restituisce un valore serializzabile in JSON