ElementoXmlElemento
Gli oggetti XmlElement rappresentano elementi in un documento XML
rapporto ereditario
proprietà dei membri
namespaceURI
Stringa, URI dello spazio dei nomi dell'elemento di query. Se il nodo selezionato non ha uno 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 uno spazio dei nomi, questa proprietà restituisce NULL
1String XmlElement.prefix;
localName
String, il nome locale dell'elemento della query. Se il nodo selezionato non ha uno spazio dei nomi, questa proprietà è equivalente a nodeName
1readonly String XmlElement.localName;
tagName
String, restituisce il nome del tag dell'elemento
1readonly String XmlElement.tagName;
id
Stringa, interroga e imposta l'attributo id dell'elemento
1String XmlElement.id;
innerHTML
Stringa, interroga e imposta il testo HTML dei discendenti dell'elemento selezionato, valido solo in modalità html. Durante l'esecuzione della query, restituisce la codifica HTML di tutti i nodi secondari all'interno del nodo dell'elemento; durante l'impostazione, elimina tutti i nodi secondari e sostituiscili con la decodifica HTML specificata.
1String XmlElement.innerHTML;
outerHTML
String, interroga il testo HTML dell'elemento selezionato e dei suoi discendenti, valido solo in modalità html. Durante l'esecuzione di una query, restituisce la codifica HTML dell'elemento e di tutti i nodi figlio all'interno del nodo.
1readonly String XmlElement.outerHTML;
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 del nodo selezionato. Se il nodo selezionato non è un elemento, questa proprietà restituisce NULL.
1readonly XmlNamedNodeMap XmlElement.attributes;
nodeType
Intero, restituisce il tipo di nodo del nodo
1readonly Integer XmlElement.nodeType;
Il nodeType di oggetti diversi restituirà valori diversi:
- XmlElement: ELEMENT_NODO(1)
- XmlAttr:ATTRIBUTE_NODO(2)
- XmlText: TESTO_NODO(3)
- XmlCDATASection: CDATA_SECTION_NODE(4)
- XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
- XmlComment:COMMENT_NODE(8)
- XmlDocument: DOCUMENT_NODE(9)
- XmlDocumentType: TIPO_DOCUMENTO_NODO(10)
nodeName
String, restituisce il nome del nodo, in base al suo tipo
1readonly String XmlElement.nodeName;
Il nodeName di oggetti diversi restituirà valori diversi:
- XmlElement:nome dell'elemento
- XmlAttr: nome attributo
- XmlText: #testo
- XmlCDATASection: #cdata-sezione
- XmlProcessingInstruction: Restituisce la destinazione di destinazione specificata
- 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 oggetti diversi restituirà valori diversi:
- XmlElement: nullo
- XmlAttr: valore dell'attributo
- XmlText: il contenuto del nodo
- XmlCDATASection: il contenuto del nodo
- XmlProcessingInstruction: Restituisce i dati del contenuto specificato
- XmlComment: testo dell'annotazione
- XmlDocument: nullo
- XmlDocumentType: nullo
ownerDocument
XmlDocument, restituisce l'elemento radice del nodo (XmlDocumentoggetto)
1readonly XmlDocument XmlElement.ownerDocument;
parentNode
XmlNode, può restituire il nodo genitore di un nodo
1readonly XmlNode XmlElement.parentNode;
childNodes
XmlNodeList, restituisce l'elenco dei nodi figlio del nodo specificato
1readonly XmlNodeList XmlElement.childNodes;
children
XmlNodeList, restituisce l'elenco 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 precedente a un nodo (allo stesso livello dell'albero). Se non esiste un nodo di questo tipo, questa proprietà restituisce null.
1readonly XmlNode XmlElement.previousSibling;
nextSibling
XmlNode, restituisce il nodo immediatamente successivo a un elemento (nello stesso livello dell'albero). Se non esiste tale nodo, l'attributo 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 nodo immediatamente precedente a un nodo (allo stesso livello dell'albero). Se non esiste tale nodo, questa proprietà restituisce null.
1readonly XmlNode XmlElement.previousElementSibling;
nextElementSibling
XmlNode, restituisce il nodo dell'elemento immediatamente successivo a un elemento (nello stesso livello dell'albero). Se non esiste tale nodo, l'attributo restituisce null.
1readonly XmlNode XmlElement.nextElementSibling;
textContent
Stringa, 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
Interrogare il valore di un attributo per nome
1String XmlElement.getAttribute(String name);
Parametri di chiamata:
- name: String, specifica il nome dell'attributo della query
Risultati restituiti:
- String, restituisce il valore dell'attributo
getAttributeNS
Ottieni il valore dell'attributo in base all'URI dello spazio dei nomi e al nome
1
2String XmlElement.getAttributeNS(String namespaceURI,
String localName);
Parametri di chiamata:
- namespaceURI: stringa, che specifica l'URI dello spazio dei nomi della query
- localName: String, specifica il nome dell'attributo della query
Risultati restituiti:
- String, restituisce il valore dell'attributo
setAttribute
Crea o modifica una nuova proprietà
1
2XmlElement.setAttribute(String name,
String value);
Parametri di chiamata:
- name: String, specifica il nome dell'attributo 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, questo metodo crea una nuova proprietà
setAttributeNS
Creare o modificare le proprietà dello spazio dei nomi
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 dell'attributo 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 da un URI dello spazio dei nomi e da un nome completo costituito da un prefisso dello spazio dei nomi, due punti e un nome locale nello spazio dei nomi. Oltre a modificare il valore di un attributo, puoi utilizzare questo metodo anche per modificare il prefisso dello spazio dei nomi dell'attributo.
removeAttribute
Rimuovi l'attributo specificato per nome
1XmlElement.removeAttribute(String name);
Parametri di chiamata:
- name: String, specifica il nome dell'attributo da eliminare
removeAttributeNS
Rimuovi le proprietà specificate 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 dell'attributo 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
Risultati restituiti:
- Boolean, se il nodo dell'elemento corrente ha l'attributo specificato, restituisce true, altrimenti restituisce false
hasAttributeNS
Interroga se il nodo corrente ha attributi 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
Risultati restituiti:
- 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. Il valore "*" corrisponde a tutti i tag
Risultati restituiti:
- XmlNodeList, il nodo XmlElement con il tag specificato nell'albero dei nodiXmlNodeListraccogliere. L'ordine dei nodi elemento restituiti è l'ordine in cui appaiono nel documento di origine.
Questo metodo attraverserà i nodi discendenti dell'elemento specificato e restituirà un nodo XmlElement.XmlNodeListOggetto che rappresenta tutti gli elementi del documento con il nome del 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 invece di attraversare i nodi 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. Il valore "*" corrisponde a tutti i tag
Risultati restituiti:
- XmlNodeList, il nodo XmlElement con il tag specificato nell'albero dei nodiXmlNodeListraccogliere. L'ordine dei nodi elemento restituiti è l'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 desideri ottenere viene specificato come 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
Risultati restituiti:
- 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 invece di attraversare i nodi discendenti di un elemento.
getElementsByClassName
Restituisce un elenco di nodi di tutti gli elementi con il nome della classe specificata
1XmlNodeList XmlElement.getElementsByClassName(String className);
Parametri di chiamata:
- className: String, il nome della classe da recuperare
Risultati restituiti:
- XmlNodeList, il nodo XmlElement con il nome della classe specificata nell'albero del documentoXmlNodeListraccogliere. L'ordine dei nodi elemento restituiti è l'ordine in cui appaiono nel documento di origine.
Questo metodo restituirà aXmlNodeListOggetto (può essere elaborato come array di sola lettura), che archivia tutti i nodi XmlElement con il nome della classe specificata nel documento. L'ordine in cui vengono archiviati è l'ordine in cui appaiono nel documento di origine.XmlNodeListL'oggetto è "live", ovvero se nel documento viene aggiunto o eliminato un elemento con il nome del tag specificato, il suo contenuto verrà automaticamente aggiornato secondo necessità.
hasChildNodes
Interroga se sono presenti nodi figlio
1Boolean XmlElement.hasChildNodes();
Risultati restituiti:
- Boolean, restituisce vero se sono presenti nodi figli, altrimenti restituisce falso
normalize
Unisci nodi di testo adiacenti ed elimina i nodi di testo vuoti
1XmlElement.normalize();
Questo metodo attraverserà tutti i nodi discendenti del nodo corrente e normalizzerà il documento eliminando 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 aver inserito o eliminato nodi.
cloneNode
Crea una copia esatta del nodo specificato
1XmlNode XmlElement.cloneNode(Boolean deep = true);
Parametri di chiamata:
- deep: Booleano, se eseguire la copia profonda, quando è vero, il nodo clonato clonerà tutti i nodi figlio del nodo originale
Risultati restituiti:
- XmlNode, restituisce il nodo copiato
Questo metodo copierà e restituirà una copia del nodo su cui è stato chiamato. Se l'argomento passato è vero, copierà ricorsivamente anche 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 un nodo Elemento viene copiato, verranno copiate tutte le sue proprietà.
lookupPrefix
Restituisce il prefisso corrispondente all'URI dello spazio dei nomi specificato sul nodo corrente
1String XmlElement.lookupPrefix(String namespaceURI);
Parametri di chiamata:
- namespaceURI: String, specifica l'URI dello spazio dei nomi corrispondente
Risultati restituiti:
- String, restituisce il prefisso corrispondente, restituisce null se non corrisponde.
lookupNamespaceURI
Restituisce l'URI dello spazio dei nomi corrispondente al prefisso specificato sul nodo corrente
1String XmlElement.lookupNamespaceURI(String prefix);
Parametri di chiamata:
- prefix: String, specifica il prefisso corrispondente
Risultati restituiti:
- 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, inserisci un nuovo nodo
- refChild:XmlNode, inserisci un nuovo nodo prima di questo nodo
Risultati restituiti:
- 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 (o i nodi creati da un documento) non possono essere inseriti in un altro documento. Cioè, l'attributoownerDocument di newChild deve essere uguale all'attributoownerDocument 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:
- newChild:XmlNode, inserisci un nuovo nodo
- refChild:XmlNode, inserisci un nuovo nodo dopo questo nodo
Risultati restituiti:
- 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 (o i nodi creati da un documento) non possono essere inseriti in un altro documento. Cioè, l'attributoownerDocument di newChild deve essere uguale all'attributoownerDocument del nodo corrente.
appendChild
Aggiunge un nuovo nodo figlio alla fine dell'elenco dei nodi figlio di un nodo
1XmlNode XmlElement.appendChild(XmlNode newChild);
Parametri di chiamata:
- newChild:XmlNode, specificare il nodo aggiunto
Risultati restituiti:
- 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 (o i nodi creati da un documento) non possono essere inseriti in un altro documento. Cioè, l'attributoownerDocument di newChild deve essere uguale all'attributoownerDocument del nodo corrente.
replaceChild
Sostituisci un nodo figlio con un altro
1
2XmlNode XmlElement.replaceChild(XmlNode newChild,
XmlNode oldChild);
Parametri di chiamata:
Risultati restituiti:
- XmlNode, Se la sostituzione ha esito positivo, questo metodo può restituire il nodo sostituito. Se la sostituzione fallisce, restituisce 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 (o i nodi creati da un documento) non possono essere inseriti in un altro documento. Cioè, l'attributoownerDocument di newChild deve essere uguale all'attributoownerDocument del nodo corrente.
removeChild
Rimuovere un nodo dall'elenco dei nodi figlio
1XmlNode XmlElement.removeChild(XmlNode oldChild);
Parametri di chiamata:
- oldChild:XmlNode, specifica il nodo da eliminare
Risultati restituiti:
- XmlNode, Se l'eliminazione ha esito positivo, questo metodo può restituire il nodo eliminato. Se fallisce, restituisce null.
toString
Restituisce la rappresentazione in formato stringa dell'oggetto. Generalmente viene restituito "[Oggetto nativo]". L'oggetto può essere reimplementato in base alle proprie caratteristiche.
1String XmlElement.toString();
Risultati restituiti:
- String, restituisce la rappresentazione di stringa dell'oggetto
toJSON
Restituisce una rappresentazione in formato JSON dell'oggetto, generalmente restituendo una raccolta di proprietà leggibili definite dall'oggetto.
1Value XmlElement.toJSON(String key = "");
Parametri di chiamata:
- key: Stringa, non utilizzata
Risultati restituiti:
- Value, restituisce un valore contenente JSON serializzabile